TcpClient.ConnectAsync メソッド

定義

指定されたホスト名とポート番号を使用して、非同期操作としてクライアントをリモート 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)

非同期操作として、クライアントを、指定したホストの指定した 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.ValueTask
Public Function ConnectAsync (host As String, port As Integer, cancellationToken As CancellationToken) As ValueTask

パラメーター

host
String

リモート ホストの DNS 名。

port
Int32

リモート ホストのポート番号。

cancellationToken
CancellationToken

非同期操作のキャンセルが必要であることを示すために使用できるキャンセル トークン。

戻り値

ValueTask

非同期接続操作を表すタスク。

例外

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

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

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

TcpClient は閉じています。

注釈

この操作はブロックされません。 返されたタスクは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。

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

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

Note

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

Note

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

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Connect(String, Int32)スローされる例外に関するページを参照してください。

こちらもご覧ください

適用対象

ConnectAsync(IPAddress[], Int32, CancellationToken)

指定された 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.ValueTask
Public Function ConnectAsync (addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTask

パラメーター

addresses
IPAddress[]

リモート ホストの IP アドレスの配列。

port
Int32

リモート ホストのポート番号。

cancellationToken
CancellationToken

非同期操作のキャンセルが必要であることを示すために使用できるキャンセル トークン。

戻り値

ValueTask

非同期接続操作を表すタスク。

例外

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

ポート番号が無効です。

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

Socket が閉じられました。

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

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

注釈

この操作はブロックされません。 返されたタスクは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。

このメソッドは通常、 メソッドの呼び出しの直後に BeginGetHostAddresses 使用されます。このメソッドは、1 つのホストに対して複数の IP アドレスを返すことができます。 IP アドレスの配列とポート番号で指定されたホストへの同期リモート ホスト接続を非同期操作として確立するには、このメソッドを呼び出します。 リモート ホストと接続した後、 メソッドを 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(IPAddress, Int32, CancellationToken)

指定された 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.ValueTask
Public Function ConnectAsync (address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTask

パラメーター

address
IPAddress

リモート ホストの IP アドレス。

port
Int32

リモート ホストのポート番号。

cancellationToken
CancellationToken

非同期操作のキャンセルが必要であることを示すために使用できるキャンセル トークン。

戻り値

ValueTask

非同期接続操作を表すタスク。

例外

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

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

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

TcpClient は閉じています。

注釈

この操作はブロックされません。 返されたタスクは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。

指定した IP アドレスとポート番号への同期リモート ホスト接続を非同期操作として確立するには、このメソッドを呼び出します。 リモート ホストと接続した後、 メソッドを 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(String, Int32)

非同期操作として、クライアントを、指定したホストの指定した 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.Task
Public Function ConnectAsync (host As String, port As Integer) As Task

パラメーター

host
String

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

port
Int32

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

戻り値

Task

非同期操作を表すタスク オブジェクト。

例外

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

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

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

TcpClient は閉じています。

注釈

この操作はブロックされません。 返された Returns Task オブジェクトは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。

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

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

Note

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

Note

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

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Connect(String, Int32)スローされる例外に関するページを参照してください。

こちらもご覧ください

適用対象

ConnectAsync(IPEndPoint, CancellationToken)

指定したエンドポイントを非同期操作として使用して、クライアントをリモート 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.ValueTask
Public Function ConnectAsync (remoteEP As IPEndPoint, cancellationToken As CancellationToken) As ValueTask

パラメーター

remoteEP
IPEndPoint

接続先の IPEndPoint

cancellationToken
CancellationToken

この操作を取り消す必要があることを示す通知を伝達するために使用するキャンセル トークン。

戻り値

ValueTask

非同期操作を表すタスク。

注釈

この操作はブロックされません。 返された Returns Task オブジェクトは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。

指定した への同期リモート ホスト接続を確立するには、このメソッドを呼び出します 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 を有効にしていることを確認します。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Connect(IPEndPoint)スローされる例外に関するページを参照してください。

適用対象

ConnectAsync(IPAddress[], Int32)

指定された 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.Task
Public Function ConnectAsync (addresses As IPAddress(), port As Integer) As Task

パラメーター

addresses
IPAddress[]

接続先ホストの IPAddress 配列。

port
Int32

接続先のポート番号。

戻り値

Task

非同期操作を表すタスク オブジェクト。

例外

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

ポート番号が無効です。

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

Socket が閉じられました。

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

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

注釈

この操作はブロックされません。 返された Returns Task オブジェクトは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。

このメソッドは通常、 メソッドの呼び出しの直後に BeginGetHostAddresses 使用されます。このメソッドは、1 つのホストに対して複数の IP アドレスを返すことができます。 要素の配列 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(IPAddress, Int32)

指定された 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.Task
Public Function ConnectAsync (address As IPAddress, port As Integer) As Task

パラメーター

address
IPAddress

接続先ホストの IPAddress

port
Int32

接続先のポート番号。

戻り値

Task

非同期操作を表すタスク オブジェクト。

例外

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

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

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

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)

指定したエンドポイントを非同期操作として使用して、クライアントをリモート 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.Task
Public Function ConnectAsync (remoteEP As IPEndPoint) As Task

パラメーター

remoteEP
IPEndPoint

接続先の IPEndPoint

戻り値

Task

非同期操作を表すタスク。

注釈

この操作はブロックされません。 返された Task オブジェクトは、TCP 接続が確立された後に完了します。 このメソッドは、接続要求の進行中に呼び出し元のスレッドをブロックしません。

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

Note

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

Note

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

Note

IPv6 アドレスの使用中に "このプロトコル バージョンはサポートされていません" というメッセージが表示された を受け取った NotSupportedException 場合は、 を渡 InterNetworkV6してコンストラクターで IPv6 を有効にしてください。

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Connect(IPEndPoint)スローされる例外に関するページを参照してください。

適用対象