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)

Source:

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)

Source:

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)

Source:

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 一。

有关使用异步编程模型的详细信息，请参阅 异步调用同步方法。