TcpListener.ExclusiveAddressUse プロパティ

.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

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)

プロパティ値
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

C#

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

プラットフォーム

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

参照

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