TcpListener.AcceptTcpClientAsync 方法

定义

命名空间:

System.Net.Sockets

程序集:

System.Net.Sockets.dll

重载

AcceptTcpClientAsync()	接受挂起的连接请求以作为异步操作。
AcceptTcpClientAsync(CancellationToken)	接受挂起的连接请求作为可取消的异步操作。

AcceptTcpClientAsync()

Source:

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 错误代码文档，获取有关错误的详细说明。

注解

此操作不会阻止。 返回 Task<TResult> 的对象将在接受 TCP 连接后完成。

TcpClient.GetStream使用 方法获取 中NetworkStream返回TcpClient的 的基础Task<TResult>。 将 NetworkStream 为你提供用于通过远程主机发送和接收的方法。 使用 时， TcpClient请务必调用其 Close 方法。 如果想要比 TcpClient 产品/服务更大的灵活性，请考虑使用 AcceptSocket 或 AcceptSocketAsync。

备注

当你在应用程序中启用网络跟踪后，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework 中的网络跟踪。

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 AcceptTcpClient()异常。

另请参阅

• TcpClient
• AcceptSocket()
• Socket
• NetworkStream

AcceptTcpClientAsync(CancellationToken)

Source:

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

取消令牌已取消。 此异常存储在返回的任务中。

注解

此操作不会阻止。 返回 Task<TResult> 的对象将在接受 TCP 连接后完成。

TcpClient.GetStream使用 方法获取 中NetworkStream返回TcpClient的 的基础Task<TResult>。 将 NetworkStream 为你提供用于通过远程主机发送和接收的方法。 使用 时， TcpClient请务必调用其 Close 方法。 如果想要比 TcpClient 产品/服务更大的灵活性，请考虑使用 AcceptSocket 或 AcceptSocketAsync。

备注

当你在应用程序中启用网络跟踪后，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework 中的网络跟踪。

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 AcceptTcpClient()异常。