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

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

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

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

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

适用于

反馈

此页面是否有帮助？