TcpClient.Connect メソッド

  • リファレンス

定義

名前空間:
System.Net.Sockets
アセンブリ:
System.Net.Sockets.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.dll

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

オーバーロード

Connect(IPEndPoint)

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

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

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

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

Connect(IPEndPoint)

ソース:
TCPClient.cs
ソース:
TCPClient.cs
ソース:
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 を有効にしていることを確認します。

こちらもご覧ください

適用対象

Connect(IPAddress, Int32)

ソース:
TCPClient.cs
ソース:
TCPClient.cs
ソース:
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 を有効にしていることを確認します。

こちらもご覧ください

適用対象

Connect(IPAddress[], Int32)

ソース:
TCPClient.cs
ソース:
TCPClient.cs
ソース:
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 を有効にしていることを確認します。

こちらもご覧ください

適用対象

Connect(String, Int32)

ソース:
TCPClient.cs
ソース:
TCPClient.cs
ソース:
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 アドレスの両方に解決されるホストに接続する場合、IPv6 アドレスへの接続は最初に IPv4 アドレスの前に試行されます。 これは、ホストが IPv6 アドレスでリッスンしていない場合に、接続を確立する時間を遅らせる効果がある可能性があります。

注意

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

Note

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

こちらもご覧ください

適用対象