TcpClient.Connect メソッド

定義

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

オーバーロード

Connect(IPEndPoint)

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

Connect(IPAddress, Int32)

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

Connect(IPAddress[], Int32)

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

Connect(String, Int32)

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

Connect(IPEndPoint)

指定されたリモート ネットワーク エンドポイントを使用してリモート 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

例外

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

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

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 使用して、データの送受信を行います。

Note

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

Note

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

Note

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

こちらもご覧ください

適用対象

Connect(IPAddress, Int32)

指定された 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

接続先のポート番号。

例外

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

portMinPortMaxPort の間の値ではありません。

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

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 使用して、データの送受信を行います。

Note

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

Note

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

Note

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

こちらもご覧ください

適用対象

Connect(IPAddress[], Int32)

指定された 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

接続先のポート番号。

例外

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

ポート番号が無効です。

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

Socket が閉じられました。

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

このメソッドは、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 使用して、データの送受信を行います。

Note

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

Note

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

Note

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

こちらもご覧ください

適用対象

Connect(String, Int32)

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

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

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

例外

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

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

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

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

Note

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

Note

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

こちらもご覧ください

適用対象