UdpClient.ExclusiveAddressUse プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

UdpClient.ExclusiveAddressUse プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

UdpClient で 1 つのクライアントだけがポートを使用できるかどうかを指定する Boolean 値を取得または設定します。

名前空間: System.Net.Sockets
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Property ExclusiveAddressUse As
 Boolean

Visual Basic (使用法)

Dim instance As UdpClient
Dim value As Boolean

value = instance.ExclusiveAddressUse

instance.ExclusiveAddressUse = value

public bool ExclusiveAddressUse { get;
 set; }

C++

public:
property bool ExclusiveAddressUse {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_ExclusiveAddressUse ()

/** @property */
public void set_ExclusiveAddressUse (boolean
 value)

JScript

public function get ExclusiveAddressUse
 () : boolean

public function set ExclusiveAddressUse
 (value : boolean)

プロパティ値
UdpClient で、1 つのクライアントだけが特定のポートを使用できる場合は true。それ以外の場合は false。既定値は、Windows Server 2003 および Windows XP Service Pack 2 以降では true で、その他のすべてのバージョンでは false です。

例外

例外の種類	条件
SocketException	基になるソケットへのアクセスを試みているときにエラーが発生しました。
ObjectDisposedException	基になる Socket は閉じられています。

解説

既定では、複数のクライアントが特定のポートを使用できます。ただし、ポートに送信されるネットワークトラフィックの操作を実行できるのはいずれか 1 つのクライアントだけです。ExclusiveAddressUse プロパティを使用して、複数のクライアントが特定のポートを使用しないようにできます。

このプロパティは、基になるソケットがクライアントポートにバインドされる前に設定される必要があります。System.Net.Sockets.UdpClient(Int32)、System.Net.Sockets.UdpClient(Int32,AddressFamily)、System.Net.Sockets.UdpClient(IPEndPoint)、または System.Net.Sockets.UdpClient(String,Int32) の各コンストラクタを呼び出した結果、クライアントポートがバインドされるため、その後は ExclusiveAddressUse プロパティを設定できません。

Windows XP Home Edition, Windows XP Professional x64 Edition, Windows Server 2003 プラットフォームメモ : Service Pack 2 以降では、このプロパティの既定値は true です。

Windows Server 2003 プラットフォームメモ : このプロパティの既定値は true です。

Windows 2000 プラットフォームメモ : アプリケーションでこのプロパティを使用するには、管理者として実行する必要があります。

Windows XP Home Edition, Windows XP Professional x64 Edition, Windows Server 2003 プラットフォームメモ : Service Pack 1 では、アプリケーションでこのプロパティを使用するには、管理者として実行する必要があります。

使用例

UdpClient を作成して、ExclusiveAddressUse プロパティを取得および設定するコード例を次に示します。

public static void GetSetExclusiveAddressUse(UdpClient
 u)
{
    // Don't allow another client to bind to this port.
    u.ExclusiveAddressUse = true;
    Console.WriteLine("ExclusiveAddressUse value is {0}",
        u.ExclusiveAddressUse);
}

C++

static void GetSetExclusiveAddressUse( UdpClient^
 u )
{
   // Don't allow another client to bind to this port.
   u->ExclusiveAddressUse = true;
   Console::WriteLine(  "ExclusiveAddressUse value is {0}", u->ExclusiveAddressUse
 );
}