TcpListener コンストラクター

定義

名前空間:

System.Net.Sockets

アセンブリ:

System.Net.Sockets.dll

TcpListener クラスの新しいインスタンスを初期化します。

オーバーロード

TcpListener(Int32)	互換性のために残されています。 指定したポートを待機する TcpListener クラスの新しいインスタンスを初期化します。
TcpListener(IPEndPoint)	指定したローカル エンドポイントを使用して、TcpListener クラスの新しいインスタンスを初期化します。
TcpListener(IPAddress, Int32)	指定したローカル IP アドレスとポート番号で受信接続の試行を待機する、TcpListener クラスの新しいインスタンスを初期化します。

TcpListener(Int32)

注意事項

This constructor has been deprecated. Use TcpListener(IPAddress localaddr, int port) instead.

指定したポートを待機する TcpListener クラスの新しいインスタンスを初期化します。

public:
 TcpListener(int port);

[System.Obsolete("This constructor has been deprecated. Use TcpListener(IPAddress localaddr, int port) instead.")]
public TcpListener (int port);

[<System.Obsolete("This constructor has been deprecated. Use TcpListener(IPAddress localaddr, int port) instead.")>]
new System.Net.Sockets.TcpListener : int -> System.Net.Sockets.TcpListener

Public Sub New (port As Integer)

パラメーター

port

Int32

受信接続の試行を待機するポート。

属性

ObsoleteAttribute

例外

ArgumentOutOfRangeException

port が MinPort と MaxPort の間の値ではありません。

例

次のコード例では、ローカル ポート番号を使用して を TcpListener 作成します。

//Creates an instance of the TcpListener class by providing a local 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 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 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

注釈

このコンストラクターは今後は使用しません。 または TcpListener.TcpListener(IPEndPoint) コンストラクターをTcpListener.TcpListener(IPAddress, Int32)使用します。

このコンストラクターを使用すると、受信接続の試行をリッスンするポート番号を指定できます。 このコンストラクターを使用すると、基になるサービス プロバイダーによって、最も適切なネットワーク アドレスが割り当てられます。 使用するローカル ポートを気にしない場合は、ポート番号に 0 を指定できます。 この場合、サービス プロバイダーは使用可能なエフェメラル ポート番号を割り当てます。 この方法を使用する場合は、 プロパティを使用して、割り当てられているローカル ネットワーク アドレスとポート番号を LocalEndpoint 検出できます。

メソッドを Start 呼び出して、着信接続の試行のリッスンを開始します。

こちらもご覧ください

• Start()

TcpListener(IPEndPoint)

指定したローカル エンドポイントを使用して、TcpListener クラスの新しいインスタンスを初期化します。

public:
 TcpListener(System::Net::IPEndPoint ^ localEP);

public TcpListener (System.Net.IPEndPoint localEP);

new System.Net.Sockets.TcpListener : System.Net.IPEndPoint -> System.Net.Sockets.TcpListener

Public Sub New (localEP As IPEndPoint)

パラメーター

localEP

IPEndPoint

リスナー Socket のバインド先のローカル エンドポイントを表す IPEndPoint。

例外

ArgumentNullException

localEP が nullです。

例

次のコード例では、ローカル エンドポイントを使用して クラスの TcpListener インスタンスを作成します。

//Creates an instance of the TcpListener class by providing a local endpoint.

IPAddress^ ipAddress = Dns::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );

try
{
   TcpListener^ tcpListener = gcnew TcpListener( ipLocalEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the TcpListener class by providing a local endpoint.

IPAddress ipAddress = Dns.Resolve(Dns.GetHostName()).AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 11000);

try{
    TcpListener tcpListener = new TcpListener(ipLocalEndPoint);
}
catch ( Exception e ){
    Console.WriteLine( e.ToString());
}

'Creates an instance of the TcpListener class by providing a local endpoint.
Dim ipAddress As IPAddress = Dns.Resolve(Dns.GetHostName()).AddressList(0)
Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 11000)

Try
   Dim tcpListener As New TcpListener(ipLocalEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

注釈

このコンストラクターを使用すると、受信接続の試行をリッスンするローカル IP アドレスとポート番号を指定できます。 このコンストラクターを使用する前に、目的のローカル IP アドレスとポート番号を使用して を IPEndPoint 作成する必要があります。 これを IPEndPoint パラメーターとしてコンストラクターに localEP 渡します。

どのローカル アドレスが割り当てられているか気にしない場合は、アドレス パラメーターとして を使用して IPAddress.Any を作成IPEndPointできます。基になるサービス プロバイダーは、最も適切なネットワーク アドレスを割り当てます。 これは、複数のネットワーク インターフェイスがある場合にアプリケーションを簡略化するのに役立つ場合があります。 どのローカル ポートが使用されているか気にしない場合は、ポート番号に 0 を IPEndPoint 使用して を作成できます。 この場合、サービス プロバイダーは使用可能なエフェメラル ポート番号を割り当てます。 この方法を使用する場合は、 プロパティを使用して、割り当てられているローカル ネットワーク アドレスとポート番号を LocalEndpoint 検出できます。

メソッドを Start 呼び出して、着信接続の試行のリッスンを開始します。

Note

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

こちらもご覧ください

• IPEndPoint
• Start()

TcpListener(IPAddress, Int32)

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

public:
 TcpListener(System::Net::IPAddress ^ localaddr, int port);

public TcpListener (System.Net.IPAddress localaddr, int port);

new System.Net.Sockets.TcpListener : System.Net.IPAddress * int -> System.Net.Sockets.TcpListener

Public Sub New (localaddr As IPAddress, port As Integer)

パラメーター

localaddr

IPAddress

ローカル IP アドレスを表す IPAddress。

port

Int32

受信接続の試行を待機するポート。

例外

ArgumentNullException

localaddr が nullです。

ArgumentOutOfRangeException

port が MinPort と MaxPort の間の値ではありません。

例

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

//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 = 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.
   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

注釈

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

メソッドを Start 呼び出して、着信接続の試行のリッスンを開始します。

Note

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

こちらもご覧ください

• IPAddress
• Start()