TcpClient.ConnectAsync メソッド

定義

名前空間:: System.Net.Sockets

アセンブリ:: netstandard.dll, System.Net.Sockets.dll

アセンブリ:: System.Net.Sockets.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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

ソース:: 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.ValueTask

Public Function ConnectAsync (host As String, port As Integer, cancellationToken As CancellationToken) As ValueTask

パラメーター

host: String

リモートホストの DNS 名。

port: Int32

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

cancellationToken: CancellationToken

非同期操作の通知に使用できるキャンセルトークンを取り消す必要があります。

返品

ValueTask

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

例外

ArgumentNullException

host パラメーターはnull。

ArgumentOutOfRangeException

port パラメーターは、MinPortとMaxPortの間にありません。

SocketException

ソケットにアクセスするときにエラーが発生しました。

ObjectDisposedException

TcpClient は閉じています。

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

注釈

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

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

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

Note

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

Note

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

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

こちらもご覧ください

適用対象

ConnectAsync(IPAddress[], Int32, CancellationToken)

ソース:: TCPClient.cs

ソース:: TCPClient.cs

ソース:: 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.ValueTask

Public Function ConnectAsync (addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTask

パラメーター

addresses: IPAddress[]

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

port: Int32

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

cancellationToken: CancellationToken

非同期操作の通知に使用できるキャンセルトークンを取り消す必要があります。

返品

ValueTask

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

例外

ArgumentNullException

addresses パラメーターはnull。

ArgumentOutOfRangeException

ポート番号が無効です。

SocketException

ソケットにアクセスしようとしたときにエラーが発生しました。

ObjectDisposedException

Socketが閉じられました。

SecurityException

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

NotSupportedException

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

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

注釈

通常、このメソッドは、1 つのホストに対して複数の IP アドレスを返すことができる BeginGetHostAddresses メソッドの呼び出しの直後に使用されます。このメソッドを呼び出して、IP アドレスの配列とポート番号で指定されたホストへの同期リモートホスト接続を非同期操作として確立します。リモートホストと接続した後、 GetStream メソッドを使用して基になる NetworkStreamを取得します。この NetworkStream を使用して、データを送受信します。

Note

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

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

こちらもご覧ください

TcpListener

適用対象

ConnectAsync(IPAddress, Int32, CancellationToken)

ソース:: TCPClient.cs

ソース:: TCPClient.cs

ソース:: 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.ValueTask

Public Function ConnectAsync (address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTask

パラメーター

address: IPAddress

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

port: Int32

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

cancellationToken: CancellationToken

非同期操作の通知に使用できるキャンセルトークンを取り消す必要があります。

返品

ValueTask

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

例外

ArgumentNullException

address パラメーターはnull。

ArgumentOutOfRangeException

portは、MinPortとMaxPortの間にありません。

SocketException

ソケットにアクセスするときにエラーが発生しました。

ObjectDisposedException

TcpClient は閉じています。

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

注釈

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

Note

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

こちらもご覧ください

GetStream()

適用対象

ConnectAsync(String, Int32)

ソース:: TCPClient.cs

ソース:: TCPClient.cs

ソース:: 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.Task

Public Function ConnectAsync (host As String, port As Integer) As Task

パラメーター

host: String

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

port: Int32

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

返品

Task

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

例外

ArgumentNullException

host パラメーターはnull。

ArgumentOutOfRangeException

port パラメーターは、MinPortとMaxPortの間にありません。

SocketException

ソケットにアクセスするときにエラーが発生しました。

ObjectDisposedException

TcpClient は閉じています。

注釈

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

Note

こちらもご覧ください

適用対象

ConnectAsync(IPEndPoint, CancellationToken)

ソース:: TCPClient.cs

ソース:: TCPClient.cs

ソース:: 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.ValueTask

Public Function ConnectAsync (remoteEP As IPEndPoint, cancellationToken As CancellationToken) As ValueTask

パラメーター

remoteEP: IPEndPoint

接続先の IPEndPoint 。

cancellationToken: CancellationToken

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

返品

ValueTask

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

例外

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

注釈

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

Note

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

適用対象

ConnectAsync(IPAddress[], Int32)

ソース:: TCPClient.cs

ソース:: TCPClient.cs

ソース:: 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.Task

Public Function ConnectAsync (addresses As IPAddress(), port As Integer) As Task

パラメーター

addresses: IPAddress[]

接続先のホストの IPAddress 配列。

port: Int32

接続先のポート番号。

返品

Task

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

例外

ArgumentNullException

addresses パラメーターはnull。

ArgumentOutOfRangeException

ポート番号が無効です。

SocketException

ソケットにアクセスしようとしたときにエラーが発生しました。

ObjectDisposedException

Socketが閉じられました。

SecurityException

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

NotSupportedException

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

注釈

通常、このメソッドは、1 つのホストに対して複数の IP アドレスを返すことができる BeginGetHostAddresses メソッドの呼び出しの直後に使用されます。このメソッドを呼び出して、 IPAddress 要素の配列で指定されたホストへの同期リモートホスト接続と、非同期操作としてポート番号を確立します。リモートホストと接続した後、 GetStream メソッドを使用して基になる NetworkStreamを取得します。この NetworkStream を使用して、データを送受信します。

Note

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

こちらもご覧ください

TcpListener

適用対象

ConnectAsync(IPAddress, Int32)

ソース:: TCPClient.cs

ソース:: TCPClient.cs

ソース:: 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.Task

Public Function ConnectAsync (address As IPAddress, port As Integer) As Task

パラメーター

address: IPAddress

接続先のホストの IPAddress 。

port: Int32

接続先のポート番号。

返品

Task

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

例外

ArgumentNullException

address パラメーターはnull。

ArgumentOutOfRangeException

portは、MinPortとMaxPortの間にありません。

SocketException

ソケットにアクセスするときにエラーが発生しました。

ObjectDisposedException

TcpClient は閉じています。

注釈

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

Note

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

こちらもご覧ください

GetStream()

適用対象

ConnectAsync(IPEndPoint)

ソース:: TCPClient.cs

ソース:: TCPClient.cs

ソース:: 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.Task

Public Function ConnectAsync (remoteEP As IPEndPoint) As Task

パラメーター

remoteEP: IPEndPoint

接続先の IPEndPoint 。

返品

Task

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

注釈

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

Note

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

Note

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

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

適用対象

フィードバック

このページはお役に立ちましたか?