UdpClient.ExclusiveAddressUse プロパティ

.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

C#

public bool ExclusiveAddressUse { get;
 set; }

C++

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

J#

/** @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 プロパティを取得および設定するコード例を次に示します。

C#

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
 );
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
UdpClient クラス
UdpClient メンバ
System.Net.Sockets 名前空間