TcpClient.Connect メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したホスト名とポート番号を使用して、クライアントをリモート 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 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 の Network Tracingを参照してください。
Note
IPv6 アドレスの使用中にメッセージ This protocol version is not supported を含む NotSupportedException を受信した場合は、 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)
パラメーター
- port
- Int32
接続先のポート番号。
例外
address パラメーターはnull。
ソケットにアクセスするときにエラーが発生しました。
TcpClient は閉じています。
例
次のコード例では、IP アドレスとポート番号を使用してリモート ホストに接続します。
//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 の Network Tracingを参照してください。
Note
IPv6 アドレスの使用中にメッセージ This protocol version is not supported を含む NotSupportedException を受信した場合は、 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)
パラメーター
- port
- Int32
接続先のポート番号。
例外
ipAddresses パラメーターはnull。
ポート番号が無効です。
ソケットにアクセスしようとしたときにエラーが発生しました。
Socketが閉じられました。
呼び出し履歴の上位の呼び出し元には、要求された操作に対するアクセス許可がありません。
このメソッドは、 InterNetwork フラグまたは InterNetworkV6 フラグを使用するソケットに対して有効です。
例
次のコード例では、IP アドレスとポート番号を使用してリモート ホストに接続します。
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");
}
注釈
通常、このメソッドは、1 つのホストに対して複数の IP アドレスを返すことができる BeginGetHostAddresses メソッドの呼び出しの直後に使用されます。
Connect メソッドを呼び出して、IPAddress要素の配列とポート番号で指定されたホストへの同期リモート ホスト接続を確立します。
Connect メソッドは、接続または失敗するまでブロックされます。 リモート ホストと接続した後、 GetStream メソッドを使用して基になる NetworkStreamを取得します。 この NetworkStream を使用して、データを送受信します。
Note
SocketExceptionを受け取った場合は、SocketException.ErrorCodeを使用して特定のエラー コードを取得します。 このコードを取得した後、エラーの詳細な説明については、 Windows ソケット バージョン 2 API のエラー コード ドキュメントを参照してください。
Note
このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「.NET Framework の Network Tracingを参照してください。
Note
IPv6 アドレスの使用中にメッセージ This protocol version is not supported を含む NotSupportedException を受信した場合は、 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。
ソケットにアクセスするときにエラーが発生しました。
TcpClient は閉じています。
例
次のコード例では、ホスト名とポート番号を使用してリモート ホストに接続します。
//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 アドレスと IPv4 アドレスの両方に解決されるホストに接続するために Connect(String, Int32) メソッドが呼び出された場合、IPv6 アドレスへの接続は、IPv4 アドレスの前に最初に試行されます。 これは、ホストが IPv6 アドレスをリッスンしていない場合に、接続を確立する時間を遅らせる効果がある可能性があります。
Note
SocketExceptionを受け取った場合は、SocketException.ErrorCodeを使用して特定のエラー コードを取得します。 このコードを取得した後、エラーの詳細な説明については、 Windows ソケット バージョン 2 API のエラー コード ドキュメントを参照してください。
Note
このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「.NET Framework の Network Tracingを参照してください。