Socket.DisconnectAsync 方法

定义

命名空间:

System.Net.Sockets

程序集:

System.Net.Sockets.dll

重载

DisconnectAsync(SocketAsyncEventArgs)	开始异步请求从远程终结点断开连接。
DisconnectAsync(Boolean, CancellationToken)	断开连接套接字与远程主机的连接。

DisconnectAsync(SocketAsyncEventArgs)

Source:

Socket.cs

开始异步请求从远程终结点断开连接。

public:
 bool DisconnectAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);

public bool DisconnectAsync (System.Net.Sockets.SocketAsyncEventArgs e);

member this.DisconnectAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Function DisconnectAsync (e As SocketAsyncEventArgs) As Boolean

参数

e

SocketAsyncEventArgs

要用于此异步套接字操作的 SocketAsyncEventArgs 对象。

返回

Boolean

如果 I/O 操作挂起，则为 true。 操作完成时，将引发 e 参数的 Completed 事件。

如果 I/O 操作同步完成，则为 false。 在这种情况下，将不会引发 e 参数的 Completed 事件，并且可能在方法调用返回后立即检查作为参数传递的 e 对象以检索操作的结果。

例外

ArgumentNullException

e 参数不能为 NULL。

InvalidOperationException

已经在使用 e 参数中指定的 SocketAsyncEventArgs 对象执行套接字操作。

ObjectDisposedException

Socket 已关闭。

SocketException

尝试访问套接字时出错。

注解

使用面向连接的协议时，调用 DisconnectAsync 方法会请求与远程终结点断开连接。 如果在 参数中e将 设置为 SocketAsyncEventArgs.DisconnectReuseSockettrue ，则可以重复使用套接字。

另请参阅

• SocketAsyncEventArgs
• Completed
• DisconnectReuseSocket

DisconnectAsync(Boolean, CancellationToken)

Source:

Socket.Tasks.cs

断开连接套接字与远程主机的连接。

public System.Threading.Tasks.ValueTask DisconnectAsync (bool reuseSocket, System.Threading.CancellationToken cancellationToken = default);

member this.DisconnectAsync : bool * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function DisconnectAsync (reuseSocket As Boolean, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

参数

reuseSocket

Boolean

指示断开连接后套接字是否应可供重复使用。

cancellationToken

CancellationToken

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

返回

ValueTask

在套接字断开连接时完成的异步任务。

例外

ObjectDisposedException

Socket 对象已关闭。

SocketException

尝试访问套接字时出错。

OperationCanceledException

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

注解

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