SocketTaskExtensions.ConnectAsync 方法

参考

定义

命名空间:: System.Net.Sockets

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

程序集:: System.dll

程序集:: netstandard.dll

重要

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

重载

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)

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

建立与远程主机的连接，该连接由 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

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

ValueTask

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

例外

ArgumentNullException

addresses 参数不能为 NULL。

ArgumentException

参数 addresses 不能为空数组。

ArgumentOutOfRangeException

port 小于 MinPort。

- 或 -

port 大于 MaxPort。

InvalidOperationException

正在 Socket 侦听。

SocketException

尝试访问套接字时出错。

ObjectDisposedException

Socket 已关闭。

SecurityException

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

OperationCanceledException

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

适用于

ConnectAsync(Socket, IPAddress, Int32, CancellationToken)

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

建立与远程主机的连接，该连接由 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

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

ValueTask

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

例外

ArgumentNullException

address 参数不能为 NULL。

ArgumentOutOfRangeException

port 小于 MinPort。

- 或 -

port 大于 MaxPort。

InvalidOperationException

正在 Socket 侦听。

SocketException

尝试访问套接字时出错。

ObjectDisposedException

Socket 已关闭。

SecurityException

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

OperationCanceledException

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

适用于

ConnectAsync(Socket, String, Int32)

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

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

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

远程主机的端口号。

Task

异步任务。

例外

ArgumentNullException

host 参数不能为 NULL。

ArgumentOutOfRangeException

port 小于 MinPort。

- 或 -

port 大于 MaxPort。

InvalidOperationException

正在 Socket 侦听。

SocketException

尝试访问套接字时出错。

ObjectDisposedException

Socket 已关闭。

SecurityException

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

适用于

ConnectAsync(Socket, String, Int32, CancellationToken)

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

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

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

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

ValueTask

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

例外

ArgumentNullException

host 参数不能为 NULL。

ArgumentOutOfRangeException

port 小于 MinPort。

- 或 -

port 大于 MaxPort。

InvalidOperationException

正在 Socket 侦听。

SocketException

尝试访问套接字时出错。

ObjectDisposedException

Socket 已关闭。

SecurityException

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

OperationCanceledException

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

适用于

ConnectAsync(Socket, IPAddress, Int32)

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

与远程主机建立连接。主机由 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

远程主机的端口号。

Task

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

例外

ArgumentNullException

address 参数不能为 NULL。

ArgumentOutOfRangeException

port 小于 MinPort。

- 或 -

port 大于 MaxPort。

InvalidOperationException

正在 Socket 侦听。

SocketException

尝试访问套接字时出错。

ObjectDisposedException

Socket 已关闭。

SecurityException

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

适用于

ConnectAsync(Socket, EndPoint, CancellationToken)

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

与远程主机建立连接。

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

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

ValueTask

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

例外

ArgumentNullException

remoteEP 参数不能为 NULL。

InvalidOperationException

正在 Socket 侦听。

SocketException

尝试访问套接字时出错。

NotSupportedException

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

ObjectDisposedException

Socket 已关闭。

SecurityException

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

OperationCanceledException

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

适用于

ConnectAsync(Socket, EndPoint)

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

与远程主机建立连接。

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

表示远程设备的终结点。

Task

异步任务。

例外

ArgumentNullException

remoteEP 参数不能为 NULL。

InvalidOperationException

正在 Socket 侦听。

SocketException

尝试访问套接字时出错。

NotSupportedException

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

ObjectDisposedException

Socket 已关闭。

SecurityException

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

适用于

ConnectAsync(Socket, IPAddress[], Int32)

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

Source:: SocketTaskExtensions.cs

与远程主机建立连接。主机由 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

远程主机的端口号。

Task

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

例外

ArgumentNullException

addresses 参数不能为 NULL。

ArgumentException

参数 addresses 不能为空数组。

ArgumentOutOfRangeException

port 小于 MinPort。

- 或 -

port 大于 MaxPort。

InvalidOperationException

正在 Socket 侦听。

SocketException

尝试访问套接字时出错。

ObjectDisposedException

Socket 已关闭。

SecurityException

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

适用于

通过

SocketTaskExtensions.ConnectAsync 方法

定义

重载

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

参数

返回

例外

适用于

ConnectAsync(Socket, IPAddress, Int32, CancellationToken)

参数

返回

例外

适用于

ConnectAsync(Socket, String, Int32)

参数

返回

例外

适用于

ConnectAsync(Socket, String, Int32, CancellationToken)

参数

返回

例外

适用于

ConnectAsync(Socket, IPAddress, Int32)

参数

返回

例外

适用于

ConnectAsync(Socket, EndPoint, CancellationToken)

参数

返回

例外

适用于

ConnectAsync(Socket, EndPoint)

参数

返回

例外

适用于

ConnectAsync(Socket, IPAddress[], Int32)

参数

返回

例外

适用于

其他资源