TcpClient.BeginConnect メソッド

  • リファレンス

定義

名前空間:
System.Net.Sockets
アセンブリ:
System.Net.Sockets.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.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
ソース:
TCPClient.cs
ソース:
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);
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
ソース:
TCPClient.cs
ソース:
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);
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
ソース:
TCPClient.cs
ソース:
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);
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 使用します。

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

適用対象