TcpListener コンストラクター

リファレンス

定義

名前空間:: System.Net.Sockets

アセンブリ:: System.Net.Sockets.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

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

TcpListener(Int32)

注意事項

This method has been deprecated. Please use TcpListener(IPAddress localaddr, int port) instead. https://go.microsoft.com/fwlink/?linkid=14202

注意事項

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

注意事項

This method has been deprecated. Please use TcpListener(IPAddress localaddr, int port) instead. http://go.microsoft.com/fwlink/?linkid=14202

注意事項

Use TcpListener(IPAddress localaddr, int port).

注意事項

Use TcpListener (IPAddress address, int port) instead

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

public:
 TcpListener(int port);

[System.Obsolete("This method has been deprecated. Please use TcpListener(IPAddress localaddr, int port) instead. https://go.microsoft.com/fwlink/?linkid=14202")]
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 method has been deprecated. Please use TcpListener(IPAddress localaddr, int port) instead. http://go.microsoft.com/fwlink/?linkid=14202")]
public TcpListener (int port);

[System.Obsolete("Use TcpListener(IPAddress localaddr, int port).")]
public TcpListener (int port);

[System.Obsolete("Use TcpListener (IPAddress address, int port) instead")]
public TcpListener (int port);

[<System.Obsolete("This method has been deprecated. Please use TcpListener(IPAddress localaddr, int port) instead. https://go.microsoft.com/fwlink/?linkid=14202")>]
new System.Net.Sockets.TcpListener : int -> System.Net.Sockets.TcpListener

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

[<System.Obsolete("This method has been deprecated. Please use TcpListener(IPAddress localaddr, int port) instead. http://go.microsoft.com/fwlink/?linkid=14202")>]
new System.Net.Sockets.TcpListener : int -> System.Net.Sockets.TcpListener

[<System.Obsolete("Use TcpListener(IPAddress localaddr, int port).")>]
new System.Net.Sockets.TcpListener : int -> System.Net.Sockets.TcpListener

[<System.Obsolete("Use TcpListener (IPAddress address, 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 アドレスとポート番号を指定できます。このコンストラクターを使用する前に、目的の IPEndPoint ローカル IP アドレスとポート番号を使用して作成する必要があります。これを IPEndPoint パラメーターとしてコンストラクターに localEP 渡します。

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

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

注意

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

こちらもご覧ください

適用対象

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 呼び出して、着信接続の試行のリッスンを開始します。

注意

こちらもご覧ください

適用対象