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 位址時收到具有訊息 This protocol version is not supported 的 NotSupportedException，則請傳遞 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[]

至少一個指定遠端主機的 IPAddress。

port

Int32

遠端主機的通訊埠編號。

requestCallback

AsyncCallback

AsyncCallback 委派，會於作業完成時參考要叫用的方法。

state

Object

包含連線作業資訊的使用者定義物件。 作業完成時會將這個物件傳遞至 requestCallback 委派。

傳回

IAsyncResult

參考非同步連接的 IAsyncResult 物件。

例外狀況

ArgumentNullException

addresses 參數為 null。

SocketException

嘗試存取通訊端時發生錯誤。

ObjectDisposedException

Socket 已關閉。

SecurityException

在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。

ArgumentOutOfRangeException

連接埠號碼無效。

備註

BeginConnect異步操作必須藉由呼叫 EndConnect 方法來完成。 一般而言，委派會叫用 asyncCallback 方法。

這個方法不會在作業完成之前封鎖。 若要封鎖直到作業完成為止，請使用其中 Connect 一個 方法多載。

如需使用異步程序設計模型的詳細資訊，請參閱 以異步方式呼叫同步方法。

此方法通常會在呼叫 BeginGetHostAddresses 方法之後立即使用，這可以傳回單一主機的多個IP位址。

注意

如果您在使用 IPv6 位址時收到具有訊息 This protocol version is not supported 的 NotSupportedException，則請傳遞 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 一個 方法多載。

如需使用異步程序設計模型的詳細資訊，請參閱 以異步方式呼叫同步方法。