共用方式為


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)

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

可用來通知應該取消非同步作業的取消權杖。

傳回

表示非同步連線作業的工作。

例外狀況

addresses 參數不可以是 Null。

參數 addresses 不可以是空陣列。

port 小於 MinPort

-或-

port 大於 MaxPort

嘗試存取通訊端時發生錯誤。

在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

適用於

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

可用來通知應該取消非同步作業的取消權杖。

傳回

表示非同步連線作業的工作。

例外狀況

address 參數不可以是 Null。

port 小於 MinPort

-或-

port 大於 MaxPort

嘗試存取通訊端時發生錯誤。

在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

適用於

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

遠端主機的連接埠號碼。

傳回

非同步工作。

例外狀況

host 參數不可以是 Null。

port 小於 MinPort

-或-

port 大於 MaxPort

嘗試存取通訊端時發生錯誤。

在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。

適用於

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

可用來通知應該取消非同步作業的取消權杖。

傳回

表示非同步連線作業的工作。

例外狀況

host 參數不可以是 Null。

port 小於 MinPort

-或-

port 大於 MaxPort

嘗試存取通訊端時發生錯誤。

在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

適用於

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

遠端主機的連接埠號碼。

傳回

表示非同步連線作業的工作。

例外狀況

address 參數不可以是 Null。

port 小於 MinPort

-或-

port 大於 MaxPort

嘗試存取通訊端時發生錯誤。

在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。

適用於

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

可用來通知應該取消非同步作業的取消權杖。

傳回

表示非同步連線作業的工作。

例外狀況

remoteEP 參數不可以是 Null。

嘗試存取通訊端時發生錯誤。

本機端點和 remoteEP 參數不是相同的位址系列。

在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

適用於

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

表示遠端主機的端點。

傳回

非同步工作。

例外狀況

remoteEP 參數不可以是 Null。

嘗試存取通訊端時發生錯誤。

本機端點和 remoteEP 參數不是相同的位址系列。

在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。

適用於

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

遠端主機的連接埠號碼。

傳回

表示非同步作業的工作。

例外狀況

addresses 參數不可以是 Null。

參數 addresses 不可以是空陣列。

port 小於 MinPort

-或-

port 大於 MaxPort

嘗試存取通訊端時發生錯誤。

在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。

適用於