TcpListener.AcceptSocketAsync 方法

定义

命名空间:

System.Net.Sockets

程序集:

System.Net.Sockets.dll

重载

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

AcceptSocketAsync()

Source:

TCPListener.cs

接受挂起的连接请求以作为异步操作。

public:
 System::Threading::Tasks::Task<System::Net::Sockets::Socket ^> ^ AcceptSocketAsync();

public System.Threading.Tasks.Task<System.Net.Sockets.Socket> AcceptSocketAsync ();

member this.AcceptSocketAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.Socket>

Public Function AcceptSocketAsync () As Task(Of Socket)

返回

Task<Socket>

表示异步操作的任务对象。 任务对象上的 Result 属性返回了用于发送和接收数据的 Socket。

例外

InvalidOperationException

尚未通过调用 Start() 来启动该侦听器。

注解

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

Socket返回的 Task<TResult> 是使用远程主机的 IP 地址和端口号初始化的 。 可以使用 类中Socket提供的任何 Send 和 Receive 方法与远程主机通信。 使用 完 后， Socket请务必调用其 Close 方法。 如果应用程序相对简单，请考虑使用 AcceptTcpClient 方法而不是 AcceptSocketAsync 方法。 TcpClient 提供了在阻止同步模式下通过网络发送和接收数据的简单方法。

备注

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

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

另请参阅

• AcceptTcpClient()
• Socket
• Pending()

AcceptSocketAsync(CancellationToken)

Source:

TCPListener.cs

接受挂起的连接请求作为可取消的异步操作。

public:
 System::Threading::Tasks::ValueTask<System::Net::Sockets::Socket ^> AcceptSocketAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket> AcceptSocketAsync (System.Threading.CancellationToken cancellationToken);

member this.AcceptSocketAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket>

Public Function AcceptSocketAsync (cancellationToken As CancellationToken) As ValueTask(Of Socket)

参数

cancellationToken

CancellationToken

可用于取消异步操作的取消标记。

返回

ValueTask<Socket>

表示异步操作的任务对象。 任务对象上的 Result 属性返回了用于发送和接收数据的 Socket。

例外

OperationCanceledException

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

注解

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

Socket返回的 Task<TResult> 是使用远程主机的 IP 地址和端口号初始化的 。 可以使用 类中Socket提供的任何 Send 和 Receive 方法与远程主机通信。 使用 完 后， Socket请务必调用其 Close 方法。 如果应用程序相对简单，请考虑使用 AcceptTcpClient 方法而不是 AcceptSocketAsync 方法。 TcpClient 提供了在阻止同步模式下通过网络发送和接收数据的简单方法。

备注

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

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