TcpListener コンストラクタ

.NET Framework クラス ライブラリ リファレンス

TcpListener コンストラクタ (Int32)

メモ : このコンストラクタは、互換性のために残されています。

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

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

Visual Basic (宣言)

<ObsoleteAttribute("This method has been deprecated. Please
 use TcpListener(IPAddress localaddr, int port) instead. http://go.microsoft.com/fwlink/?linkid=14202")>
 _
Public Sub New ( _
    port As Integer _
)

Visual Basic (使用法)

Dim port As Integer

Dim instance As New TcpListener(port)

C#

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

C++

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

J#

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

JScript

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

パラメータ

port

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

例外

例外の種類	条件
ArgumentOutOfRangeException	port が MinPort と MaxPort の間の値ではありません。

解説

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

このコンストラクタを使用すると、受信接続の試行を待機するポート番号を指定できます。基になるサービス プロバイダは、このコンストラクタを使用して最も適切なネットワーク アドレスを割り当てます。どのローカル ポートを使用してもかまわない場合は、ポート番号を 0 に指定することもできます。この場合、サービス プロバイダは 1024 ～ 5000 の範囲で使用できるポート番号を割り当てます。この方法を使用する場合、LocalEndpoint プロパティを使用することによって、既に割り当てられているローカル ネットワーク アドレスとポート番号を知ることができます。

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

使用例

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

Visual Basic

'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
            

C#

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

C++

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

J#

// Creates an instance of the TcpListener class by 
// providing a local 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
サポート対象 : 1.0、1.1
2.0 では、互換性のために残されています (コンパイル時に警告)
.NET Compact Framework
サポート対象 : 1.0
2.0 では、互換性のために残されています (コンパイル時に警告)

参照

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

TcpListener コンストラクタ (IPEndPoint)

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

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

Visual Basic (宣言)

Public Sub New ( _
    localEP As IPEndPoint _
)

Visual Basic (使用法)

Dim localEP As IPEndPoint

Dim instance As New TcpListener(localEP)

C#

public TcpListener (
    IPEndPoint localEP
)

C++

public:
TcpListener (
    IPEndPoint^ localEP
)

J#

public TcpListener (
    IPEndPoint localEP
)

JScript

public function TcpListener (
    localEP : IPEndPoint
)

パラメータ

localEP

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

例外

例外の種類	条件
ArgumentNullException	localEP が null 参照 (Visual Basic では Nothing) です。

解説

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

どのローカル アドレスが割り当てられていてもかまわない場合は、IPAddress.Any をアドレス パラメータとして使用して IPEndPoint を作成します。すると、基になるサービス プロバイダが最も適切なローカル ネットワーク アドレスを割り当てます。複数のネットワーク インターフェイスがある場合は、これを使用することによってアプリケーションを簡素化できることがあります。使用するローカル ポートについても特に指定がない場合は、ポート番号 0 を使用して IPEndPoint を作成します。この場合、サービス プロバイダは 1024 ～ 5000 の範囲で使用できるポート番号を割り当てます。この方法を使用する場合、LocalEndpoint プロパティを使用することによって、既に割り当てられているローカル ネットワーク アドレスとポート番号を知ることができます。

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

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

使用例

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

Visual Basic

'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

C#

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

C++

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

J#

// Creates an instance of the TcpListener class by providing a 
// local endpoint.
IPAddress ipAddress = (IPAddress)Dns.Resolve(
    Dns.GetHostName()).get_AddressList().get_Item(0);
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 11000);
try {
    TcpListener tcpListener = new TcpListener(ipLocalEndPoint);
}
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 名前空間
IPEndPoint クラス
Start

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim localaddr As IPAddress
Dim port As Integer

Dim instance As New TcpListener(localaddr,
 port)

C#

public TcpListener (
    IPAddress localaddr,
    int port
)

C++

public:
TcpListener (
    IPAddress^ localaddr, 
    int port
)

J#

public TcpListener (
    IPAddress localaddr, 
    int port
)

JScript

public function TcpListener (
    localaddr : IPAddress, 
    port : int
)

パラメータ

localaddr

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

port

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

例外

例外の種類	条件
ArgumentNullException	localaddr が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	port が MinPort と MaxPort の間の値ではありません。

解説

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

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

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

使用例

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

Visual Basic

'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
         

C#

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

C++

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

J#

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

TcpListener コンストラクタ

TcpListener クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
TcpListener (Int32)	指定したポートを待機する TcpListener クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
TcpListener (IPEndPoint)	指定したローカル エンドポイントを使用して、TcpListener クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
TcpListener (IPAddress, Int32)	指定したローカル IP アドレスとポート番号で受信接続の試行を待機する、TcpListener クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。

参照

関連項目

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