SocketTaskExtensions.ConnectAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| 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 不能為空。
addresses參數不能是空陣列。
它 Socket 正在傾聽。
嘗試存取該套接字時發生錯誤。
該店 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 不能為空。
它 Socket 正在傾聽。
嘗試存取該套接字時發生錯誤。
該店 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 不能為空。
它 Socket 正在傾聽。
嘗試存取該套接字時發生錯誤。
該店 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 不能為空。
它 Socket 正在傾聽。
嘗試存取該套接字時發生錯誤。
該店 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 不能為空。
它 Socket 正在傾聽。
嘗試存取該套接字時發生錯誤。
該店 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 不能為空。
它 Socket 正在傾聽。
嘗試存取該套接字時發生錯誤。
本地端點與 remoteEP 參數並非同一地址族。
該店 Socket 已經關閉。
呼叫堆疊中較高的呼叫者沒有該請求操作的權限。
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
適用於
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 不能為空。
它 Socket 正在傾聽。
嘗試存取該套接字時發生錯誤。
本地端點與 remoteEP 參數並非同一地址族。
該店 Socket 已經關閉。
呼叫堆疊中較高的呼叫者沒有該請求操作的權限。
適用於
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 不能為空。
addresses參數不能是空陣列。
它 Socket 正在傾聽。
嘗試存取該套接字時發生錯誤。
該店 Socket 已經關閉。
呼叫堆疊中較高的呼叫者沒有該請求操作的權限。
