SocketTaskExtensions.ConnectAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 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)
建立由 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 不可以是空陣列。
正在 Socket 接聽。
嘗試存取通訊端時發生錯誤。
在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。
取消標記已取消。 此例外狀況會儲存在傳回的工作中。
適用於
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。
正在 Socket 接聽。
嘗試存取通訊端時發生錯誤。
在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。
取消標記已取消。 此例外狀況會儲存在傳回的工作中。
適用於
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。
正在 Socket 接聽。
嘗試存取通訊端時發生錯誤。
在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。
適用於
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。
正在 Socket 接聽。
嘗試存取通訊端時發生錯誤。
在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。
取消標記已取消。 此例外狀況會儲存在傳回的工作中。
適用於
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。
正在 Socket 接聽。
嘗試存取通訊端時發生錯誤。
在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。
適用於
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。
正在 Socket 接聽。
嘗試存取通訊端時發生錯誤。
本機端點和 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。
正在 Socket 接聽。
嘗試存取通訊端時發生錯誤。
本機端點和 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 不可以是空陣列。
正在 Socket 接聽。
嘗試存取通訊端時發生錯誤。
在呼叫堆疊中位置較高的呼叫端對於要求的作業沒有權限。
適用於
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應