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

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

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

TcpListener.ExclusiveAddressUse プロパティ

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

TcpListener で、1 つの基になるソケットだけに特定のポートの待機を許可するかどうかを指定する Boolean 値を取得または設定します。

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

Visual Basic (宣言)

Public Property ExclusiveAddressUse As
 Boolean

Visual Basic (使用法)

Dim instance As TcpListener
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)

プロパティ値
TcpListener で、1 つの TcpListener だけに特定のポートの待機を許可する場合は true。それ以外の場合は false。. 既定値は、Windows Server 2003 および Windows XP Service Pack 2 以降では true で、その他のすべてのバージョンでは false です。

例外

例外の種類	条件
InvalidOperationException	TcpListener が開始されています。Stop メソッドを呼び出して、ExclusiveAddressUse プロパティを設定してください。
SocketException	基になるソケットへのアクセスを試みているときにエラーが発生しました。
ObjectDisposedException	基になる Socket は閉じられています。

解説

既定では、複数のリスナが特定のポートを待機できます。ただし、ポートに送信されるネットワークトラフィックの操作を実行できるのはいずれか 1 つのリスナだけです。複数のリスナが特定のポートをバインドしようとした場合は、より具体的な IP アドレスを持ったリスナが、ポートに送信されるネットワークトラフィックを処理します。ExclusiveAddressUse プロパティを使用して、複数のリスナが特定のポートを待機しないようにできます。

Start を呼び出す前にこのプロパティを設定するか、Stop メソッドを呼び出してからこのプロパティを設定します。

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 では、アプリケーションでこのプロパティを使用するには、管理者として実行する必要があります。

使用例

ExclusiveAddressUse プロパティの取得と設定を行うコード例を次に示します。

Visual Basic

Public Shared Sub GetSetExclusiveAddressUse(t
 As TcpListener)
   ' Set Exclusive Address Use for the underlying socket.
   t.ExclusiveAddressUse = True
   Console.WriteLine("ExclusiveAddressUse value is {0}",
 t.ExclusiveAddressUse)
End Sub 'GetSetExclusiveAddressUse

public static void GetSetExclusiveAddressUse(TcpListener
 t)
{
    // Set Exclusive Address Use for the underlying socket.
    t.ExclusiveAddressUse = true;
    Console.WriteLine("ExclusiveAddressUse value is {0}",
        t.ExclusiveAddressUse);
}

C++

public:
    static void GetSetExclusiveAddressUse(TcpListener^
 listener)
    {
        // Set Exclusive Address Use for the underlying socket.
        listener->ExclusiveAddressUse = true;
        Console::WriteLine("ExclusiveAddressUse value is {0}",
            listener->ExclusiveAddressUse);
    }