共用方式為


TcpClient.BeginConnect 方法

定義

開始遠端主機連接的非同步要求。

多載

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 物件。

例外狀況

address 參數為 null

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

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

連接埠號碼無效。

備註

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

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

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

注意

如果您在使用 IPv6 位址時收到具有訊息 This protocol version is not supported 的 NotSupportedException,則請傳遞 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[]

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

port
Int32

遠端主機的通訊埠編號。

requestCallback
AsyncCallback

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

state
Object

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

傳回

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

例外狀況

addresses 參數為 null

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

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

連接埠號碼無效。

備註

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

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

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

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

注意

如果您在使用 IPv6 位址時收到具有訊息 This protocol version is not supported 的 NotSupportedException,則請傳遞 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 物件。

例外狀況

host 參數為 null

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

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

連接埠號碼無效。

備註

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

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

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

適用於