TcpClient.ConnectAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定されたホスト名とポート番号を使用して、非同期操作としてクライアントをリモート TCP ホストに接続します。
オーバーロード
| ConnectAsync(String, Int32, CancellationToken) |
非同期操作として、クライアントを、指定したホストの指定した TCP ポートに接続します。 |
| ConnectAsync(IPAddress[], Int32, CancellationToken) |
指定された IP アドレスとポート番号を使用して、非同期操作としてクライアントをリモート TCP ホストに接続します。 |
| ConnectAsync(IPAddress, Int32, CancellationToken) |
指定された IP アドレスとポート番号を使用して、非同期操作としてクライアントをリモート TCP ホストに接続します。 |
| ConnectAsync(String, Int32) |
非同期操作として、クライアントを、指定したホストの指定した TCP ポートに接続します。 |
| ConnectAsync(IPEndPoint, CancellationToken) |
指定したエンドポイントを非同期操作として使用して、クライアントをリモート TCP ホストに接続します。 |
| ConnectAsync(IPAddress[], Int32) |
指定された IP アドレスとポート番号を使用して、非同期操作としてクライアントをリモート TCP ホストに接続します。 |
| ConnectAsync(IPAddress, Int32) |
指定された IP アドレスとポート番号を使用して、非同期操作としてクライアントをリモート TCP ホストに接続します。 |
| ConnectAsync(IPEndPoint) |
指定したエンドポイントを非同期操作として使用して、クライアントをリモート TCP ホストに接続します。 |
ConnectAsync(String, Int32, CancellationToken)
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
非同期操作として、クライアントを、指定したホストの指定した TCP ポートに接続します。
public:
System::Threading::Tasks::ValueTask ConnectAsync(System::String ^ host, int port, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.ValueTask ConnectAsync (string host, int port, System.Threading.CancellationToken cancellationToken);member this.ConnectAsync : string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ConnectAsync (host As String, port As Integer, cancellationToken As CancellationToken) As ValueTaskパラメーター
- host
- String
リモート ホストの DNS 名。
- port
- Int32
リモート ホストのポート番号。
- cancellationToken
- CancellationToken
非同期操作のキャンセルが必要であることを示すために使用できるキャンセル トークン。
戻り値
非同期接続操作を表すタスク。
例外
host パラメーターが null です。
ソケットへのアクセス中にエラーが発生しました。
TcpClient は閉じています。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
この操作はブロックされません。 返されたタスクは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。
指定したホスト名とポート番号への同期リモート ホスト接続を非同期操作として確立するには、このメソッドを呼び出します。 リモート ホストと接続した後、 メソッドを GetStream 使用して基になる NetworkStreamを取得します。 これを NetworkStream 使用して、データの送受信を行います。
IPv6 が有効で、 メソッドが呼び出されて ConnectAsync(String, Int32) IPv6 アドレスと IPv4 アドレスの両方に解決されるホストに接続する場合、IPv4 アドレスの前に IPv6 アドレスへの接続が最初に試行されます。 これは、ホストが IPv6 アドレスでリッスンしていない場合に、接続を確立する時間を遅らせる効果がある可能性があります。
注意
を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Connect(String, Int32)スローされる例外に関するページを参照してください。
こちらもご覧ください
適用対象
ConnectAsync(IPAddress[], Int32, CancellationToken)
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
指定された IP アドレスとポート番号を使用して、非同期操作としてクライアントをリモート TCP ホストに接続します。
public:
System::Threading::Tasks::ValueTask ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress[] addresses, int port, System.Threading.CancellationToken cancellationToken);member this.ConnectAsync : System.Net.IPAddress[] * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ConnectAsync (addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTaskパラメーター
- addresses
- IPAddress[]
リモート ホストの IP アドレスの配列。
- port
- Int32
リモート ホストのポート番号。
- cancellationToken
- CancellationToken
非同期操作のキャンセルが必要であることを示すために使用できるキャンセル トークン。
戻り値
非同期接続操作を表すタスク。
例外
ipAddresses パラメーターが null です。
ポート番号が無効です。
ソケットへのアクセスを試行しているときにエラーが発生しました。
Socket が閉じられました。
呼び出し履歴の上位にある呼び出し元には、要求された操作に対するアクセス許可がありません。
このメソッドは、InterNetwork フラグまたは InterNetworkV6 フラグを使用するソケットで有効です。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
この操作はブロックされません。 返されたタスクは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。
このメソッドは通常、 メソッドの呼び出しの直後に BeginGetHostAddresses 使用されます。このメソッドは、1 つのホストに対して複数の IP アドレスを返すことができます。 IP アドレスの配列とポート番号で指定されたホストへの同期リモート ホスト接続を非同期操作として確立するには、このメソッドを呼び出します。 リモート ホストと接続した後、 メソッドを GetStream 使用して基になる NetworkStreamを取得します。 これを NetworkStream 使用して、データの送受信を行います。
注意
を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。
注意
IPv6 アドレスの使用中に NotSupportedException とメッセージ This protocol version is not supported が表示される場合は、 を渡 InterNetworkV6してコンストラクターで IPv6 を有効にしていることを確認します。
このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Connect(IPAddress[], Int32)スローされる例外に関するページを参照してください。
こちらもご覧ください
適用対象
ConnectAsync(IPAddress, Int32, CancellationToken)
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
指定された IP アドレスとポート番号を使用して、非同期操作としてクライアントをリモート TCP ホストに接続します。
public:
System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPAddress ^ address, int port, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress address, int port, System.Threading.CancellationToken cancellationToken);member this.ConnectAsync : System.Net.IPAddress * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ConnectAsync (address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTaskパラメーター
- address
- IPAddress
リモート ホストの IP アドレス。
- port
- Int32
リモート ホストのポート番号。
- cancellationToken
- CancellationToken
非同期操作のキャンセルが必要であることを示すために使用できるキャンセル トークン。
戻り値
非同期接続操作を表すタスク。
例外
address パラメーターが null です。
ソケットへのアクセス中にエラーが発生しました。
TcpClient は閉じています。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
この操作はブロックされません。 返されたタスクは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。
指定した IP アドレスとポート番号への同期リモート ホスト接続を非同期操作として確立するには、このメソッドを呼び出します。 リモート ホストと接続した後、 メソッドを GetStream 使用して基になる NetworkStreamを取得します。 これを NetworkStream 使用して、データの送受信を行います。
注意
を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。
注意
IPv6 アドレスの使用中に NotSupportedException とメッセージ This protocol version is not supported が表示される場合は、 を渡 InterNetworkV6してコンストラクターで IPv6 を有効にしていることを確認します。
このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Connect(IPAddress, Int32)スローされる例外に関するページを参照してください。
こちらもご覧ください
適用対象
ConnectAsync(String, Int32)
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
非同期操作として、クライアントを、指定したホストの指定した TCP ポートに接続します。
public:
System::Threading::Tasks::Task ^ ConnectAsync(System::String ^ host, int port);public System.Threading.Tasks.Task ConnectAsync (string host, int port);member this.ConnectAsync : string * int -> System.Threading.Tasks.TaskPublic Function ConnectAsync (host As String, port As Integer) As Taskパラメーター
- host
- String
接続先のリモート ホストの DNS 名。
- port
- Int32
接続先のリモート ホストのポート番号。
戻り値
非同期操作を表すタスク オブジェクト。
例外
host パラメーターが null です。
ソケットへのアクセス中にエラーが発生しました。
TcpClient は閉じています。
注釈
この操作はブロックされません。 返された Returns Task オブジェクトは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。
このメソッドを呼び出して、指定したホスト名とポート番号への同期リモート ホスト接続を非同期操作として確立します。 リモート ホストに接続した後、 メソッドを GetStream 使用して基になる NetworkStreamを取得します。 これを NetworkStream 使用して、データの送受信を行います。
IPv6 が有効で、 メソッドが呼び出されて ConnectAsync(String, Int32) IPv6 アドレスと IPv4 アドレスの両方に解決されるホストに接続する場合、IPv6 アドレスへの接続は最初に IPv4 アドレスの前に試行されます。 これは、ホストが IPv6 アドレスでリッスンしていない場合に、接続を確立する時間を遅らせる効果がある可能性があります。
注意
を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については 、Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。
このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Connect(String, Int32)スローされる例外に関するページを参照してください。
こちらもご覧ください
適用対象
ConnectAsync(IPEndPoint, CancellationToken)
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
指定したエンドポイントを非同期操作として使用して、クライアントをリモート TCP ホストに接続します。
public:
System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPEndPoint ^ remoteEP, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPEndPoint remoteEP, System.Threading.CancellationToken cancellationToken);member this.ConnectAsync : System.Net.IPEndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Function ConnectAsync (remoteEP As IPEndPoint, cancellationToken As CancellationToken) As ValueTaskパラメーター
- remoteEP
- IPEndPoint
接続先の IPEndPoint。
- cancellationToken
- CancellationToken
この操作を取り消す必要があることを示す通知を伝達するために使用するキャンセル トークン。
戻り値
非同期操作を表すタスク。
例外
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
この操作はブロックされません。 返された Returns Task オブジェクトは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。
指定した への同期リモート ホスト接続を確立するには、このメソッドを呼び出します IPEndPoint。 を呼び出す Connect前に、IP アドレスとポート番号を IPEndPoint 使用して クラスのインスタンスを作成する必要があります。 これは IPEndPoint パラメーターとして remoteEP 使用します。 メソッドは Connect 、接続するか失敗するまでブロックします。 リモート ホストに接続した後、 メソッドを GetStream 使用して基になる NetworkStreamを取得します。 これを NetworkStream 使用して、データの送受信を行います。
注意
を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については 、Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。
Note
IPv6 アドレスの使用中に NotSupportedException とメッセージ This protocol version is not supported が表示される場合は、 を渡 InterNetworkV6してコンストラクターで IPv6 を有効にしていることを確認します。
このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Connect(IPEndPoint)スローされる例外に関するページを参照してください。
適用対象
ConnectAsync(IPAddress[], Int32)
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
指定された IP アドレスとポート番号を使用して、非同期操作としてクライアントをリモート TCP ホストに接続します。
public:
System::Threading::Tasks::Task ^ ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port);public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress[] addresses, int port);member this.ConnectAsync : System.Net.IPAddress[] * int -> System.Threading.Tasks.TaskPublic Function ConnectAsync (addresses As IPAddress(), port As Integer) As Taskパラメーター
- port
- Int32
接続先のポート番号。
戻り値
非同期操作を表すタスク オブジェクト。
例外
ipAddresses パラメーターが null です。
ポート番号が無効です。
ソケットへのアクセスを試行しているときにエラーが発生しました。
Socket が閉じられました。
呼び出し履歴の上位にある呼び出し元には、要求された操作に対するアクセス許可がありません。
このメソッドは、InterNetwork フラグまたは InterNetworkV6 フラグを使用するソケットで有効です。
注釈
この操作はブロックされません。 返された Returns Task オブジェクトは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。
このメソッドは通常、 メソッドの呼び出しの直後に BeginGetHostAddresses 使用されます。このメソッドは、1 つのホストに対して複数の IP アドレスを返すことができます。 要素の配列 IPAddress とポート番号で指定されたホストへの同期リモート ホスト接続を非同期操作として確立するには、このメソッドを呼び出します。 リモート ホストに接続した後、 メソッドを GetStream 使用して基になる NetworkStreamを取得します。 これを NetworkStream 使用して、データの送受信を行います。
注意
を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については 、Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。
注意
IPv6 アドレスの使用中に NotSupportedException とメッセージ This protocol version is not supported が表示される場合は、 を渡 InterNetworkV6してコンストラクターで IPv6 を有効にしていることを確認します。
このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Connect(IPAddress[], Int32)スローされる例外に関するページを参照してください。
こちらもご覧ください
適用対象
ConnectAsync(IPAddress, Int32)
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
指定された IP アドレスとポート番号を使用して、非同期操作としてクライアントをリモート TCP ホストに接続します。
public:
System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPAddress ^ address, int port);public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress address, int port);member this.ConnectAsync : System.Net.IPAddress * int -> System.Threading.Tasks.TaskPublic Function ConnectAsync (address As IPAddress, port As Integer) As Taskパラメーター
- port
- Int32
接続先のポート番号。
戻り値
非同期操作を表すタスク オブジェクト。
例外
address パラメーターが null です。
ソケットへのアクセス中にエラーが発生しました。
TcpClient は閉じています。
注釈
この操作はブロックされません。 返された Returns Task オブジェクトは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。
指定した IPAddress ポート番号とポート番号への同期リモート ホスト接続を非同期操作として確立するには、このメソッドを呼び出します。 リモート ホストと接続した後、 メソッドを GetStream 使用して基になる NetworkStreamを取得します。 これを NetworkStream 使用して、データの送受信を行います。
Note
を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。
Note
IPv6 アドレスの使用中に NotSupportedException とメッセージ This protocol version is not supported が表示される場合は、 を渡 InterNetworkV6してコンストラクターで IPv6 を有効にしていることを確認します。
このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Connect(IPAddress, Int32)スローされる例外に関するページを参照してください。
こちらもご覧ください
適用対象
ConnectAsync(IPEndPoint)
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
- ソース:
- TCPClient.cs
指定したエンドポイントを非同期操作として使用して、クライアントをリモート TCP ホストに接続します。
public:
System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPEndPoint ^ remoteEP);public System.Threading.Tasks.Task ConnectAsync (System.Net.IPEndPoint remoteEP);member this.ConnectAsync : System.Net.IPEndPoint -> System.Threading.Tasks.TaskPublic Function ConnectAsync (remoteEP As IPEndPoint) As Taskパラメーター
- remoteEP
- IPEndPoint
接続先の IPEndPoint。
戻り値
非同期操作を表すタスク。
注釈
この操作はブロックされません。 返された Task オブジェクトは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。
指定した への同期リモート ホスト接続を確立するには、このメソッドを呼び出します IPEndPoint。 を呼び出す Connect前に、IP アドレスとポート番号を IPEndPoint 使用して クラスのインスタンスを作成する必要があります。 これを IPEndPoint パラメーターとして remoteEP 使用します。 メソッドは Connect 、接続するか失敗するまでブロックします。 リモート ホストと接続した後、 メソッドを GetStream 使用して基になる NetworkStreamを取得します。 これを NetworkStream 使用して、データの送受信を行います。
注意
を受け取った場合は、 SocketExceptionを使用 SocketException.ErrorCode して特定のエラー コードを取得します。 このコードを取得したら、エラーの詳細な説明については、 Windows ソケット バージョン 2 API エラー コード のドキュメントを参照してください。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。
注意
IPv6 アドレスの使用中に "このプロトコル バージョンはサポートされていません" というメッセージが表示された を受け取った NotSupportedException 場合は、 を渡 InterNetworkV6してコンストラクターで IPv6 を有効にしてください。
このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Connect(IPEndPoint)スローされる例外に関するページを参照してください。
適用対象
.NET