TcpClient.Connect メソッド

定義

名前空間:

System.Net.Sockets

アセンブリ:

System.Net.Sockets.dll

指定されたホスト名とポート番号を使用してクライアントをリモート TCP ホストに接続します。

オーバーロード

Connect(IPEndPoint)	指定されたリモート ネットワーク エンドポイントを使用してリモート TCP ホストにクライアントを接続します。
Connect(IPAddress, Int32)	指定された IP アドレスとポート番号を使用してクライアントをリモート TCP ホストに接続します。
Connect(IPAddress[], Int32)	指定された IP アドレスとポート番号を使用してクライアントをリモート TCP ホストに接続します。
Connect(String, Int32)	指定されたホストの指定されたポートにクライアントを接続します。

Connect(IPEndPoint)

ソース:

TCPClient.cs

指定されたリモート ネットワーク エンドポイントを使用してリモート TCP ホストにクライアントを接続します。

public:
 void Connect(System::Net::IPEndPoint ^ remoteEP);

public void Connect (System.Net.IPEndPoint remoteEP);

member this.Connect : System.Net.IPEndPoint -> unit

Public Sub Connect (remoteEP As IPEndPoint)

パラメーター

remoteEP

IPEndPoint

接続先の IPEndPoint。

例外

ArgumentNullException

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

SocketException

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

ObjectDisposedException

TcpClient が閉じています。

例

次のコード例では、 を IPEndPoint 使用してリモート ホストに接続します。

//Uses a remote end point to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );
tcpClient->Connect( ipEndPoint );

//Uses a remote endpoint to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint (ipAddress, 11004);

tcpClient.Connect (ipEndPoint);

'Uses a remote endpoint to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)

tcpClient.Connect(ipEndPoint)

注釈

指定した への同期リモート ホスト接続を確立するには、このメソッドを呼び出します IPEndPoint。 を呼び出す Connect前に、IP アドレスとポート番号を IPEndPoint 使用して クラスのインスタンスを作成する必要があります。 これを IPEndPoint パラメーターとして remoteEP 使用します。 メソッドは Connect 、接続するか失敗するまでブロックします。 リモート ホストと接続した後、 メソッドを GetStream 使用して基になる NetworkStreamを取得します。 これを NetworkStream 使用して、データの送受信を行います。

注意

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

Note

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

注意

IPv6 アドレスの使用中に NotSupportedException とメッセージ This protocol version is not supported が表示される場合は、 を渡 InterNetworkV6してコンストラクターで IPv6 を有効にしていることを確認します。

こちらもご覧ください

• IPEndPoint
• GetStream()

Connect(IPAddress, Int32)

ソース:

TCPClient.cs

指定された IP アドレスとポート番号を使用してクライアントをリモート TCP ホストに接続します。

public:
 void Connect(System::Net::IPAddress ^ address, int port);

public void Connect (System.Net.IPAddress address, int port);

member this.Connect : System.Net.IPAddress * int -> unit

Public Sub Connect (address As IPAddress, port As Integer)

パラメーター

address

IPAddress

接続先ホストの IPAddress。

port

Int32

接続先のポート番号。

例外

ArgumentNullException

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

ArgumentOutOfRangeException

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

SocketException

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

ObjectDisposedException

TcpClient は閉じています。

例

次のコード例では、IP アドレスとポート番号を使用してリモート ホストに接続します。

//Uses the IP address and port number to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
tcpClient->Connect( ipAddress, 11003 );

//Uses the IP address and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];

tcpClient.Connect (ipAddress, 11003);

'Uses the IP address and port number to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
tcpClient.Connect(ipAddress, 11003)

注釈

指定した IPAddress ポート番号とポート番号への同期リモート ホスト接続を確立するには、このメソッドを呼び出します。 メソッドは Connect 、接続するか失敗するまでブロックします。 リモート ホストと接続した後、 メソッドを GetStream 使用して基になる NetworkStreamを取得します。 これを NetworkStream 使用して、データの送受信を行います。

注意

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

Note

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

注意

IPv6 アドレスの使用中に NotSupportedException とメッセージ This protocol version is not supported が表示される場合は、 を渡 InterNetworkV6してコンストラクターで IPv6 を有効にしていることを確認します。

こちらもご覧ください

• GetStream()

Connect(IPAddress[], Int32)

ソース:

TCPClient.cs

指定された IP アドレスとポート番号を使用してクライアントをリモート TCP ホストに接続します。

public:
 void Connect(cli::array <System::Net::IPAddress ^> ^ ipAddresses, int port);

public void Connect (System.Net.IPAddress[] ipAddresses, int port);

member this.Connect : System.Net.IPAddress[] * int -> unit

Public Sub Connect (ipAddresses As IPAddress(), port As Integer)

パラメーター

ipAddresses

IPAddress[]

接続先ホストの IPAddress 配列。

port

Int32

接続先のポート番号。

例外

ArgumentNullException

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

ArgumentOutOfRangeException

ポート番号が無効です。

SocketException

ソケットへのアクセスを試行しているときにエラーが発生しました。

ObjectDisposedException

Socket が閉じられました。

SecurityException

呼び出し履歴の上位にある呼び出し元には、要求された操作に対するアクセス許可がありません。

NotSupportedException

このメソッドは、InterNetwork フラグまたは InterNetworkV6 フラグを使用するソケットで有効です。

例

次のコード例では、IP アドレスとポート番号を使用してリモート ホストに接続します。

static void DoConnect( String^ host, int port )
{
   // Connect to the specified host.
   TcpClient^ t = gcnew TcpClient( AddressFamily::InterNetwork );
   array<IPAddress^>^IPAddresses = Dns::GetHostAddresses( host );
   Console::WriteLine( "Establishing Connection to {0}", host );
   t->Connect( IPAddresses, port );
   Console::WriteLine( "Connection established" );
}

static void DoConnect(string host, int port)
{
    // Connect to the specified host.
    TcpClient t = new TcpClient(AddressFamily.InterNetwork);

    IPAddress[] IPAddresses = Dns.GetHostAddresses(host);

    Console.WriteLine("Establishing connection to {0}", host);
    t.Connect(IPAddresses, port);

    Console.WriteLine("Connection established");
}

注釈

このメソッドは通常、 メソッドの呼び出しの直後に BeginGetHostAddresses 使用されます。このメソッドは、1 つのホストに対して複数の IP アドレスを返すことができます。 要素の Connect 配列 IPAddress とポート番号で指定されたホストへの同期リモート ホスト接続を確立するには、 メソッドを呼び出します。 メソッドは Connect 、接続するか失敗するまでブロックします。 リモート ホストと接続した後、 メソッドを GetStream 使用して基になる NetworkStreamを取得します。 これを NetworkStream 使用して、データの送受信を行います。

注意

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

Note

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

注意

IPv6 アドレスの使用中に NotSupportedException とメッセージ This protocol version is not supported が表示される場合は、 を渡 InterNetworkV6してコンストラクターで IPv6 を有効にしていることを確認します。

こちらもご覧ください

• TcpListener

Connect(String, Int32)

ソース:

TCPClient.cs

指定されたホストの指定されたポートにクライアントを接続します。

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

public void Connect (string hostname, int port);

member this.Connect : string * int -> unit

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

パラメーター

hostname

String

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

port

Int32

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

例外

ArgumentNullException

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

ArgumentOutOfRangeException

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

SocketException

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

ObjectDisposedException

TcpClient は閉じています。

例

次のコード例では、ホスト名とポート番号を使用してリモート ホストに接続します。

//Uses a host name and port number to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
tcpClient->Connect( "www.contoso.com", 11002 );

//Uses a host name and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
tcpClient.Connect ("www.contoso.com", 11002);

'Uses a host name and port number to establish a socket connection.
Dim tcpClient As New TcpClient()

   tcpClient.Connect("www.contoso.com", 11002)

注釈

指定したホスト名とポート番号への同期リモート ホスト接続を確立するには、このメソッドを呼び出します。 メソッドは Connect 、接続するか失敗するまでブロックします。 リモート ホストと接続した後、 メソッドを GetStream 使用して基になる NetworkStreamを取得します。 これを NetworkStream 使用して、データの送受信を行います。

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

注意

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

Note

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

こちらもご覧ください

• Connect(EndPoint)
• GetStream()