TcpClient.BeginConnect 方法

定义

命名空间:: System.Net.Sockets

程序集:: netstandard.dll, System.Net.Sockets.dll

程序集:: System.Net.Sockets.dll

程序集:: System.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

开始一个对远程主机连接的异步请求。

重载

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

Source:: TCPClient.cs

Source:: TCPClient.cs

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);

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

Source:: TCPClient.cs

Source:: TCPClient.cs

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);

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

Source:: TCPClient.cs

Source:: TCPClient.cs

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);

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

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

适用于

反馈

此页面是否有帮助？