TcpClient コンストラクター

定義

名前空間:

System.Net.Sockets

アセンブリ:

System.Net.Sockets.dll

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

オーバーロード

TcpClient()	TcpClient クラスの新しいインスタンスを初期化します。
TcpClient(IPEndPoint)	TcpClient クラスの新しいインスタンスを初期化し、指定したローカル エンドポイントにバインドします。
TcpClient(AddressFamily)	ファミリを指定して、TcpClient クラスの新しいインスタンスを初期化します。
TcpClient(String, Int32)	TcpClient クラスの新しいインスタンスを初期化し、指定したホストの指定したポートに接続します。

TcpClient()

ソース:

TCPClient.cs

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

public:
 TcpClient();

public TcpClient ();

Public Sub New ()

例

次のコード例では、パラメーターなしのコンストラクターを使用して新しい TcpClientを作成する方法を示します。

//Creates a TCPClient using the default constructor.
TcpClient^ tcpClientC = gcnew TcpClient;

//Creates a TCPClient using the default constructor.
TcpClient tcpClientC = new TcpClient ();

'Creates a TCPClient using the default constructor.
Dim tcpClientC As New TcpClient

注釈

このコンストラクターは新しい TcpClient を作成し、基になるサービス プロバイダーが最も適切なローカル IP アドレスとポート番号を割り当てることができます。 データを送受信する前に Connect 、まず メソッドを呼び出す必要があります。

注意

.NET Frameworkでは、このコンストラクターは IPv4 アドレスの種類でのみ機能します。

Note

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

こちらもご覧ください

• Connect(String, Int32)

TcpClient(IPEndPoint)

ソース:

TCPClient.cs

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

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

public TcpClient (System.Net.IPEndPoint localEP);

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

Public Sub New (localEP As IPEndPoint)

パラメーター

localEP

IPEndPoint

TCP Socket のバインド先の IPEndPoint。

例外

ArgumentNullException

localEP パラメーターが null です。

例

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

//Creates a TCPClient using a local end point.
IPAddress^ ipAddress = Dns::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );
TcpClient^ tcpClientA = gcnew TcpClient( ipLocalEndPoint );

//Creates a TCPClient using a local end point.
IPAddress ipAddress = Dns.GetHostEntry (Dns.GetHostName ()).AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 0);
TcpClient tcpClientA = new TcpClient (ipLocalEndPoint);

'Creates a TCPClient using a local endpoint.
Dim ipAddress As IPAddress = Dns.GetHostEntry(Dns.GetHostName()).AddressList(0)
   Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 0)

   Dim tcpClientA As New TcpClient(ipLocalEndPoint)

注釈

このコンストラクターは、新しい TcpClient を作成し、 パラメーターで指定された にIPEndPointlocalEPバインドします。 このコンストラクターを呼び出す前に、データの送受信元となる IP アドレスとポート番号を使用して を作成 IPEndPoint する必要があります。 接続して通信する前に、ローカル IP アドレスとポート番号を指定する必要はありません。 他のコンストラクターを使用して を TcpClient 作成すると、基になるサービス プロバイダーによって、最も適切なローカル IP アドレスとポート番号が割り当てられます。

データを送受信する Connect 前に、 メソッドを呼び出す必要があります。

Note

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

こちらもご覧ください

• IPEndPoint
• Connect(String, Int32)

TcpClient(AddressFamily)

ソース:

TCPClient.cs

ファミリを指定して、TcpClient クラスの新しいインスタンスを初期化します。

public:
 TcpClient(System::Net::Sockets::AddressFamily family);

public TcpClient (System.Net.Sockets.AddressFamily family);

new System.Net.Sockets.TcpClient : System.Net.Sockets.AddressFamily -> System.Net.Sockets.TcpClient

Public Sub New (family As AddressFamily)

パラメーター

family

AddressFamily

IP プロトコルの AddressFamily。

例外

ArgumentException

family パラメーターが AddressFamily.InterNetwork ではありません。

または

family パラメーターが AddressFamily.InterNetworkV6 ではありません。

例

次のコード例では、 クラスのインスタンスを作成する方法を TcpClient 示します。

TcpClient^ tcpClientD = gcnew TcpClient( AddressFamily::InterNetwork );

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);

Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

注釈

Note

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

TcpClient(String, Int32)

ソース:

TCPClient.cs

TcpClient クラスの新しいインスタンスを初期化し、指定したホストの指定したポートに接続します。

public:
 TcpClient(System::String ^ hostname, int port);

public TcpClient (string hostname, int port);

new System.Net.Sockets.TcpClient : string * int -> System.Net.Sockets.TcpClient

Public Sub New (hostname As String, port As Integer)

パラメーター

hostname

String

接続先のリモート ホストの DNS 名。

port

Int32

接続先のリモート ホストのポート番号。

例外

ArgumentNullException

hostname パラメーターが null です。

ArgumentOutOfRangeException

port パラメーターが MinPort と MaxPort の間にありません。

SocketException

ソケットへのアクセス中にエラーが発生しました。

例

次のコード例では、ホスト名とポート番号を使用して クラスの TcpClient インスタンスを作成する方法を示します。

// Creates a TCPClient using hostname and port.
TcpClient^ tcpClientB = gcnew TcpClient( "www.contoso.com",11000 );

//Creates a TCPClient using host name and port.
TcpClient tcpClientB = new TcpClient ("www.contoso.com", 11000);

'Creates a TCPClient using hostname and port.

Dim tcpClientB As New TcpClient("www.contoso.com", 11000)

注釈

このコンストラクターは、新 TcpClient しい を作成し、指定されたホスト名とポート番号への同期接続を試行します。 基になるサービス プロバイダーは、最も適切なローカル IP アドレスとポート番号を割り当てます。 TcpClient は、接続または失敗するまでブロックします。 このコンストラクターを使用すると、1 つの便利な手順で、初期化、DNS ホスト名の解決、接続を行うことができます。

IPv6 が有効で、 メソッドが呼び出されて TcpClient(String, Int32) IPv6 アドレスと IPv4 アドレスの両方に解決されるホストに接続する場合、IPv6 アドレスへの接続は最初に IPv4 アドレスの前に試行されます。 これは、ホストが IPv6 アドレスでリッスンしていない場合に、接続を確立する時間を遅らせる効果がある可能性があります。

注意

を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については 、Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。

Note

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

こちらもご覧ください

• TcpClient
• Connect(String, Int32)