指定したローカル 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
受信接続の試行を待機するポート。
例外
例外の種類 | 条件 |
---|---|
localaddr が null 参照 (Visual Basic では Nothing) です。 |
|
解説
このコンストラクタを使用すると、受信接続の試行を待機するローカル 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