共用方式為


TcpListener.AcceptTcpClientAsync 方法

定義

多載

AcceptTcpClientAsync()

以非同步作業的方式接受暫止連接要求。

AcceptTcpClientAsync(CancellationToken)

接受擱置的連線要求作為可取消的異步操作。

AcceptTcpClientAsync()

來源:
TCPListener.cs
來源:
TCPListener.cs
來源:
TCPListener.cs

以非同步作業的方式接受暫止連接要求。

public:
 System::Threading::Tasks::Task<System::Net::Sockets::TcpClient ^> ^ AcceptTcpClientAsync();
public System.Threading.Tasks.Task<System.Net.Sockets.TcpClient> AcceptTcpClientAsync ();
member this.AcceptTcpClientAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.TcpClient>
Public Function AcceptTcpClientAsync () As Task(Of TcpClient)

傳回

工作物件,表示非同步作業。 工作物件上的 Result 屬性會傳回用來傳送和接收資料的 TcpClient

例外狀況

尚未以呼叫 Start() 來啟動接聽項。

使用 ErrorCode 屬性取得特定錯誤碼。 一旦取得這個錯誤碼,您就可以參閱 Windows Sockets 第 2 版 API 錯誤碼文件,以取得錯誤的詳細描述。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在接受 TCP 連線之後完成。

TcpClient.GetStream使用 方法取得 NetworkStreamTask<TResult>TcpClient回的基礎 。 會 NetworkStream 提供方法,讓您使用遠端主機傳送和接收。 當您使用 TcpClient進行 時,請務必呼叫其 Close 方法。 如果您要比供應專案更大的彈性 TcpClient ,請考慮使用 AcceptSocketAcceptSocketAsync

注意

在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱 .NET Framework 中的網路追蹤

這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException仍會同步擲回。 如需預存例外狀況,請參閱 擲回的 AcceptTcpClient()例外狀況。

另請參閱

適用於

AcceptTcpClientAsync(CancellationToken)

來源:
TCPListener.cs
來源:
TCPListener.cs
來源:
TCPListener.cs

接受擱置的連線要求作為可取消的異步操作。

public:
 System::Threading::Tasks::ValueTask<System::Net::Sockets::TcpClient ^> AcceptTcpClientAsync(System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.ValueTask<System.Net.Sockets.TcpClient> AcceptTcpClientAsync (System.Threading.CancellationToken cancellationToken);
member this.AcceptTcpClientAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.TcpClient>
Public Function AcceptTcpClientAsync (cancellationToken As CancellationToken) As ValueTask(Of TcpClient)

參數

cancellationToken
CancellationToken

可用來取消異步操作的取消標記

傳回

工作物件,表示非同步作業。 工作物件上的 Result 屬性會傳回用來傳送和接收資料的 TcpClient

例外狀況

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

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在接受 TCP 連線之後完成。

TcpClient.GetStream使用 方法取得 NetworkStreamTask<TResult>TcpClient回的基礎 。 會 NetworkStream 提供方法,讓您使用遠端主機傳送和接收。 當您使用 TcpClient進行 時,請務必呼叫其 Close 方法。 如果您要比供應專案更大的彈性 TcpClient ,請考慮使用 AcceptSocketAcceptSocketAsync

注意

在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱 .NET Framework 中的網路追蹤

這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException仍會同步擲回。 如需預存例外狀況,請參閱 擲回的 AcceptTcpClient()例外狀況。

適用於