次の方法で共有


TcpListener コンストラクタ (IPAddress, Int32)

指定したローカル IP アドレスとポート番号で受信接続の試行を待機する、TcpListener クラスの新しいインスタンスを初期化します。

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

構文

'宣言
Public Sub New ( _
    localaddr As IPAddress, _
    port As Integer _
)
'使用
Dim localaddr As IPAddress
Dim port As Integer

Dim instance As New TcpListener(localaddr, port)
public TcpListener (
    IPAddress localaddr,
    int port
)
public:
TcpListener (
    IPAddress^ localaddr, 
    int port
)
public TcpListener (
    IPAddress localaddr, 
    int port
)
public function TcpListener (
    localaddr : IPAddress, 
    port : int
)

パラメータ

  • localaddr
    ローカル IP アドレスを表す IPAddress
  • port
    受信接続の試行を待機するポート。

例外

例外の種類 条件

ArgumentNullException

localaddr が null 参照 (Visual Basic では Nothing) です。

ArgumentOutOfRangeException

port が MinPortMaxPort の間の値ではありません。

解説

このコンストラクタを使用すると、受信接続の試行を待機するローカル IP アドレスおよびポート番号を指定できます。このコンストラクタを呼び出す前に、目的のローカル アドレスを使用して IPAddress を作成しておく必要があります。このとき、IPAddress を localaddr パラメータとしてコンストラクタに渡します。どのローカル アドレスに割り当ててもかまわない場合は、localaddr パラメータに IPAddress.Any を指定します。すると、基になるサービス プロバイダが最も適切なネットワーク アドレスを割り当てます。複数のネットワーク インターフェイスがある場合は、これを使用することによってアプリケーションを簡素化できることがあります。どのローカル ポートを使用してもかまわない場合は、ポート番号を 0 に指定することもできます。この場合、サービス プロバイダは 1024 ~ 5000 の範囲で使用できるポート番号を割り当てます。この方法を使用する場合、LocalEndpoint プロパティを使用することによって、既に割り当てられているローカル ネットワーク アドレスとポート番号を知ることができます。

Start メソッドを呼び出して、受信接続試行の待機を開始します。

注意

このメンバは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。

使用例

ローカル IP アドレスとポート番号を使用して、TcpListener クラスのインスタンスを作成するコード例を次に示します。

'Creates an instance of the TcpListener class by providing a local IP address and port number.
Dim ipAddress As IPAddress = Dns.Resolve("localhost").AddressList(0)

Try
   Dim tcpListener As New TcpListener(ipAddress, 13)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try
         
//Creates an instance of the TcpListener class by providing a local IP address and port number.

IPAddress ipAddress = Dns.Resolve("localhost").AddressList[0];

try{
    TcpListener tcpListener =  new TcpListener(ipAddress, 13);    
}
catch ( Exception e){
    Console.WriteLine( e.ToString());
}
    
//Creates an instance of the TcpListener class by providing a local IP address and port number.

IPAddress^ ipAddress = Dns::Resolve( "localhost" )->AddressList[ 0 ];

try
{
   TcpListener^ tcpListener = gcnew TcpListener( ipAddress,13 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}
// Creates an instance of the TcpListener class by providing a 
// local IP address and port number.
IPAddress ipAddress = (IPAddress)Dns.Resolve(
    "localhost").get_AddressList().get_Item(0);
try {
    TcpListener tcpListener = new TcpListener(ipAddress, 13);
}
catch (System.Exception e) {
    Console.WriteLine(e.ToString());
}

プラットフォーム

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、1.1、1.0

.NET Compact Framework

サポート対象 : 2.0、1.0

参照

関連項目

TcpListener クラス
TcpListener メンバ
System.Net.Sockets 名前空間
IPAddress クラス
Start