TcpListener.AcceptTcpClientAsync 方法

定義

命名空間:

System.Net.Sockets

組件:

System.Net.Sockets.dll

多載

AcceptTcpClientAsync()	以非同步作業的方式接受暫止連接要求。
AcceptTcpClientAsync(CancellationToken)	接受擱置的連線要求作為可取消的異步操作。

AcceptTcpClientAsync()

來源:

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)

傳回

Task<TcpClient>

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

例外狀況

InvalidOperationException

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

SocketException

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

備註

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

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

注意

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

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

另請參閱

• TcpClient
• AcceptSocket()
• Socket
• NetworkStream

AcceptTcpClientAsync(CancellationToken)

來源:

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

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

傳回

ValueTask<TcpClient>

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

例外狀況

OperationCanceledException

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

備註

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

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

注意

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

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