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)

來源:: SocketTaskExtensions.cs

來源:: SocketTaskExtensions.cs

來源:: 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)

來源:: SocketTaskExtensions.cs

來源:: SocketTaskExtensions.cs

來源:: 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)

來源:: SocketTaskExtensions.cs

來源:: SocketTaskExtensions.cs

來源:: 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)

來源:: SocketTaskExtensions.cs

來源:: SocketTaskExtensions.cs

來源:: 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)

來源:: SocketTaskExtensions.cs

來源:: SocketTaskExtensions.cs

來源:: 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)

來源:: SocketTaskExtensions.cs

來源:: SocketTaskExtensions.cs

來源:: 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)

來源:: SocketTaskExtensions.cs

來源:: SocketTaskExtensions.cs

來源:: 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)

來源:: SocketTaskExtensions.cs

來源:: SocketTaskExtensions.cs

來源:: 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)

參數

傳回

例外狀況

適用於

其他資源