SocketTaskExtensions.ConnectAsync 方法

定义

重载

ConnectAsync(Socket, IPAddress[], Int32, CancellationToken)

建立与远程主机的连接,该连接由 IP 地址数组和端口号指定。

ConnectAsync(Socket, IPAddress, Int32, CancellationToken)

建立与远程主机的连接,该连接由 IP 地址和端口号指定。

ConnectAsync(Socket, String, Int32)

与远程主机建立连接。 主机由主机名和端口号指定。

ConnectAsync(Socket, String, Int32, CancellationToken)

建立与远程主机的连接,该连接由主机名和端口号指定。

ConnectAsync(Socket, IPAddress, Int32)

与远程主机建立连接。 主机由 IP 地址和端口号指定。

ConnectAsync(Socket, EndPoint, CancellationToken)

与远程主机建立连接。

ConnectAsync(Socket, EndPoint)

与远程主机建立连接。

ConnectAsync(Socket, IPAddress[], Int32)

与远程主机建立连接。 主机由 IP 地址数组和端口号指定。

ConnectAsync(Socket, IPAddress[], Int32, CancellationToken)

建立与远程主机的连接,该连接由 IP 地址数组和端口号指定。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::ValueTask ConnectAsync(System::Net::Sockets::Socket ^ socket, cli::array <System::Net::IPAddress ^> ^ addresses, int port, System::Threading::CancellationToken cancellationToken);
public static System.Threading.Tasks.ValueTask ConnectAsync (this System.Net.Sockets.Socket socket, System.Net.IPAddress[] addresses, int port, System.Threading.CancellationToken cancellationToken);
static member ConnectAsync : System.Net.Sockets.Socket * System.Net.IPAddress[] * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
<Extension()>
Public Function ConnectAsync (socket As Socket, addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTask

参数

socket
Socket

对其执行连接操作的套接字。

addresses
IPAddress[]

远程主机的 IP 地址。

port
Int32

远程主机的端口号。

cancellationToken
CancellationToken

应取消可用于指示异步操作的取消令牌。

返回

表示异步连接操作的任务。

例外

addresses 参数不能为 NULL。

参数 addresses 不能为空数组。

port 小于 MinPort

- 或 -

port 大于 MaxPort

尝试访问套接字时出错。

调用堆栈中的较高调用方无权执行所请求的操作。

取消令牌已取消。 此异常存储在返回的任务中。

适用于

ConnectAsync(Socket, IPAddress, Int32, CancellationToken)

建立与远程主机的连接,该连接由 IP 地址和端口号指定。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::ValueTask ConnectAsync(System::Net::Sockets::Socket ^ socket, System::Net::IPAddress ^ address, int port, System::Threading::CancellationToken cancellationToken);
public static System.Threading.Tasks.ValueTask ConnectAsync (this System.Net.Sockets.Socket socket, System.Net.IPAddress address, int port, System.Threading.CancellationToken cancellationToken);
static member ConnectAsync : System.Net.Sockets.Socket * System.Net.IPAddress * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
<Extension()>
Public Function ConnectAsync (socket As Socket, address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTask

参数

socket
Socket

要对其执行连接操作的套接字。

address
IPAddress

远程主机的 IP 地址。

port
Int32

远程主机的端口号。

cancellationToken
CancellationToken

应取消可用于指示异步操作的取消令牌。

返回

表示异步连接操作的任务。

例外

address 参数不能为 NULL。

port 小于 MinPort

- 或 -

port 大于 MaxPort

尝试访问套接字时出错。

调用堆栈中的较高调用方无权执行所请求的操作。

取消令牌已取消。 此异常存储在返回的任务中。

适用于

ConnectAsync(Socket, String, Int32)

与远程主机建立连接。 主机由主机名和端口号指定。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ ConnectAsync(System::Net::Sockets::Socket ^ socket, System::String ^ host, int port);
public static System.Threading.Tasks.Task ConnectAsync (this System.Net.Sockets.Socket socket, string host, int port);
static member ConnectAsync : System.Net.Sockets.Socket * string * int -> System.Threading.Tasks.Task
<Extension()>
Public Function ConnectAsync (socket As Socket, host As String, port As Integer) As Task

参数

socket
Socket

要对其执行连接操作的套接字。

host
String

远程主机的名称。

port
Int32

远程主机的端口号。

返回

异步任务。

例外

host 参数不能为 NULL。

port 小于 MinPort

- 或 -

port 大于 MaxPort

尝试访问套接字时出错。

调用堆栈中的较高调用方无权执行所请求的操作。

适用于

ConnectAsync(Socket, String, Int32, CancellationToken)

建立与远程主机的连接,该连接由主机名和端口号指定。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::ValueTask ConnectAsync(System::Net::Sockets::Socket ^ socket, System::String ^ host, int port, System::Threading::CancellationToken cancellationToken);
public static System.Threading.Tasks.ValueTask ConnectAsync (this System.Net.Sockets.Socket socket, string host, int port, System.Threading.CancellationToken cancellationToken);
static member ConnectAsync : System.Net.Sockets.Socket * string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
<Extension()>
Public Function ConnectAsync (socket As Socket, host As String, port As Integer, cancellationToken As CancellationToken) As ValueTask

参数

socket
Socket

要对其执行连接操作的套接字。

host
String

远程主机的名称。

port
Int32

远程主机的端口号。

cancellationToken
CancellationToken

应取消可用于指示异步操作的取消令牌。

返回

表示异步连接操作的任务。

例外

host 参数不能为 NULL。

port 小于 MinPort

- 或 -

port 大于 MaxPort

尝试访问套接字时出错。

调用堆栈中的较高调用方无权执行所请求的操作。

取消令牌已取消。 此异常存储在返回的任务中。

适用于

ConnectAsync(Socket, IPAddress, Int32)

与远程主机建立连接。 主机由 IP 地址和端口号指定。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ ConnectAsync(System::Net::Sockets::Socket ^ socket, System::Net::IPAddress ^ address, int port);
public static System.Threading.Tasks.Task ConnectAsync (this System.Net.Sockets.Socket socket, System.Net.IPAddress address, int port);
static member ConnectAsync : System.Net.Sockets.Socket * System.Net.IPAddress * int -> System.Threading.Tasks.Task
<Extension()>
Public Function ConnectAsync (socket As Socket, address As IPAddress, port As Integer) As Task

参数

socket
Socket

要对其执行连接操作的套接字。

address
IPAddress

远程主机的 IP 地址。

port
Int32

远程主机的端口号。

返回

表示异步连接操作的任务。

例外

address 参数不能为 NULL。

port 小于 MinPort

- 或 -

port 大于 MaxPort

尝试访问套接字时出错。

调用堆栈中的较高调用方无权执行所请求的操作。

适用于

ConnectAsync(Socket, EndPoint, CancellationToken)

与远程主机建立连接。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::ValueTask ConnectAsync(System::Net::Sockets::Socket ^ socket, System::Net::EndPoint ^ remoteEP, System::Threading::CancellationToken cancellationToken);
public static System.Threading.Tasks.ValueTask ConnectAsync (this System.Net.Sockets.Socket socket, System.Net.EndPoint remoteEP, System.Threading.CancellationToken cancellationToken);
static member ConnectAsync : System.Net.Sockets.Socket * System.Net.EndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
<Extension()>
Public Function ConnectAsync (socket As Socket, remoteEP As EndPoint, cancellationToken As CancellationToken) As ValueTask

参数

socket
Socket

用于建立连接的套接字。

remoteEP
EndPoint

表示远程设备的终结点。

cancellationToken
CancellationToken

应取消可用于指示异步操作的取消令牌。

返回

表示异步连接操作的任务。

例外

remoteEP 参数不能为 NULL。

尝试访问套接字时出错。

本地终结点和 remoteEP 参数不是同一个地址系列。

调用堆栈中的较高调用方无权执行所请求的操作。

取消令牌已取消。 此异常存储在返回的任务中。

适用于

ConnectAsync(Socket, EndPoint)

与远程主机建立连接。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ ConnectAsync(System::Net::Sockets::Socket ^ socket, System::Net::EndPoint ^ remoteEP);
public static System.Threading.Tasks.Task ConnectAsync (this System.Net.Sockets.Socket socket, System.Net.EndPoint remoteEP);
static member ConnectAsync : System.Net.Sockets.Socket * System.Net.EndPoint -> System.Threading.Tasks.Task
<Extension()>
Public Function ConnectAsync (socket As Socket, remoteEP As EndPoint) As Task

参数

socket
Socket

用于建立连接的套接字。

remoteEP
EndPoint

表示远程设备的终结点。

返回

异步任务。

例外

remoteEP 参数不能为 NULL。

尝试访问套接字时出错。

本地终结点和 remoteEP 参数不是同一个地址系列。

调用堆栈中的较高调用方无权执行所请求的操作。

适用于

ConnectAsync(Socket, IPAddress[], Int32)

与远程主机建立连接。 主机由 IP 地址数组和端口号指定。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ ConnectAsync(System::Net::Sockets::Socket ^ socket, cli::array <System::Net::IPAddress ^> ^ addresses, int port);
public static System.Threading.Tasks.Task ConnectAsync (this System.Net.Sockets.Socket socket, System.Net.IPAddress[] addresses, int port);
static member ConnectAsync : System.Net.Sockets.Socket * System.Net.IPAddress[] * int -> System.Threading.Tasks.Task
<Extension()>
Public Function ConnectAsync (socket As Socket, addresses As IPAddress(), port As Integer) As Task

参数

socket
Socket

对其执行连接操作的套接字。

addresses
IPAddress[]

远程主机的 IP 地址。

port
Int32

远程主机的端口号。

返回

表示异步连接操作的任务。

例外

addresses 参数不能为 NULL。

参数 addresses 不能为空数组。

port 小于 MinPort

- 或 -

port 大于 MaxPort

尝试访问套接字时出错。

调用堆栈中的较高调用方无权执行所请求的操作。

适用于