TcpClient.BeginConnect メソッド

定義

名前空間:

System.Net.Sockets

アセンブリ:

System.Net.Sockets.dll

リモート ホスト接続への非同期要求を開始します。

オーバーロード

BeginConnect(IPAddress, Int32, AsyncCallback, Object)	リモート ホスト接続への非同期要求を開始します。 リモート ホストは、IPAddress とポート番号 (Int32) で指定されます。
BeginConnect(IPAddress[], Int32, AsyncCallback, Object)	リモート ホスト接続への非同期要求を開始します。 リモート ホストは、IPAddress 配列とポート番号 (Int32) で指定されます。
BeginConnect(String, Int32, AsyncCallback, Object)	リモート ホスト接続への非同期要求を開始します。 リモート ホストは、ホスト名 (String) とポート番号 (Int32) で指定されます。

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

ソース:

TCPClient.cs

リモート ホスト接続への非同期要求を開始します。 リモート ホストは、IPAddress とポート番号 (Int32) で指定されます。

public:
 IAsyncResult ^ BeginConnect(System::Net::IPAddress ^ address, int port, AsyncCallback ^ requestCallback, System::Object ^ state);

public IAsyncResult BeginConnect (System.Net.IPAddress address, int port, AsyncCallback? requestCallback, object? state);

member this.BeginConnect : System.Net.IPAddress * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (address As IPAddress, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

パラメーター

address

IPAddress

リモート ホストの IPAddress。

port

Int32

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

requestCallback

AsyncCallback

操作の完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。

state

Object

接続操作に関する情報を格納するユーザー定義のオブジェクト。 このオブジェクトは、操作の完了時に requestCallback デリゲートに渡されます。

戻り値

IAsyncResult

非同期接続を参照する IAsyncResult オブジェクト。

例外

ArgumentNullException

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

SocketException

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

ObjectDisposedException

Socket が閉じられました。

SecurityException

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

ArgumentOutOfRangeException

ポート番号が無効です。

注釈

非同期 BeginConnect 操作は、 メソッドを呼び出して完了する EndConnect 必要があります。 通常、 メソッドはデリゲートによって asyncCallback 呼び出されます。

このメソッドは、操作が完了するまでブロックしません。 操作が完了するまでブロックするには、いずれかのメソッド オーバーロードを Connect 使用します。

非同期プログラミング モデルの使用の詳細については、「 同期メソッドの非同期呼び出し」を参照してください。

注意

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

BeginConnect(IPAddress[], Int32, AsyncCallback, Object)

ソース:

TCPClient.cs

リモート ホスト接続への非同期要求を開始します。 リモート ホストは、IPAddress 配列とポート番号 (Int32) で指定されます。

public:
 IAsyncResult ^ BeginConnect(cli::array <System::Net::IPAddress ^> ^ addresses, int port, AsyncCallback ^ requestCallback, System::Object ^ state);

public IAsyncResult BeginConnect (System.Net.IPAddress[] addresses, int port, AsyncCallback? requestCallback, object? state);

member this.BeginConnect : System.Net.IPAddress[] * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (addresses As IPAddress(), port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

パラメーター

addresses

IPAddress[]

リモート ホストを指定する 1 つ以上の IPAddress。

port

Int32

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

requestCallback

AsyncCallback

操作の完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。

state

Object

接続操作に関する情報を格納するユーザー定義のオブジェクト。 このオブジェクトは、操作の完了時に requestCallback デリゲートに渡されます。

戻り値

IAsyncResult

非同期接続を参照する IAsyncResult オブジェクト。

例外

ArgumentNullException

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

SocketException

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

ObjectDisposedException

Socket が閉じられました。

SecurityException

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

ArgumentOutOfRangeException

ポート番号が無効です。

注釈

非同期 BeginConnect 操作は、 メソッドを呼び出して完了する EndConnect 必要があります。 通常、 メソッドはデリゲートによって asyncCallback 呼び出されます。

このメソッドは、操作が完了するまでブロックしません。 操作が完了するまでブロックするには、いずれかのメソッド オーバーロードを Connect 使用します。

非同期プログラミング モデルの使用の詳細については、「 同期メソッドの非同期呼び出し」を参照してください。

このメソッドは通常、 メソッドの呼び出しの直後に BeginGetHostAddresses 使用されます。このメソッドは、1 つのホストに対して複数の IP アドレスを返すことができます。

注意

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

BeginConnect(String, Int32, AsyncCallback, Object)

ソース:

TCPClient.cs

リモート ホスト接続への非同期要求を開始します。 リモート ホストは、ホスト名 (String) とポート番号 (Int32) で指定されます。

public:
 IAsyncResult ^ BeginConnect(System::String ^ host, int port, AsyncCallback ^ requestCallback, System::Object ^ state);

public IAsyncResult BeginConnect (string host, int port, AsyncCallback? requestCallback, object? state);

member this.BeginConnect : string * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (host As String, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

パラメーター

host

String

リモート ホストの名前。

port

Int32

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

requestCallback

AsyncCallback

操作の完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。

state

Object

接続操作に関する情報を格納するユーザー定義のオブジェクト。 このオブジェクトは、操作の完了時に requestCallback デリゲートに渡されます。

戻り値

IAsyncResult

非同期接続を参照する IAsyncResult オブジェクト。

例外

ArgumentNullException

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

SocketException

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

ObjectDisposedException

Socket が閉じられました。

SecurityException

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

ArgumentOutOfRangeException

ポート番号が無効です。

注釈

非同期 BeginConnect 操作は、 メソッドを呼び出して完了する EndConnect 必要があります。 通常、 メソッドはデリゲートによって asyncCallback 呼び出されます。

このメソッドは、操作が完了するまでブロックしません。 操作が完了するまでブロックするには、いずれかのメソッド オーバーロードを Connect 使用します。

非同期プログラミング モデルの使用の詳細については、「 同期メソッドの非同期呼び出し」を参照してください。