AspNetWebSocket.CloseOutputAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將非同步訊息傳送至用戶端以關閉連線。 如果伺服器啟始關閉連線的要求,這個方法會返回而不等待回應。
public:
override System::Threading::Tasks::Task ^ CloseOutputAsync(System::Net::WebSockets::WebSocketCloseStatus closeStatus, System::String ^ statusDescription, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task CloseOutputAsync (System.Net.WebSockets.WebSocketCloseStatus closeStatus, string statusDescription, System.Threading.CancellationToken cancellationToken);
override this.CloseOutputAsync : System.Net.WebSockets.WebSocketCloseStatus * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function CloseOutputAsync (closeStatus As WebSocketCloseStatus, statusDescription As String, cancellationToken As CancellationToken) As Task
參數
- closeStatus
- WebSocketCloseStatus
關閉作業的狀態碼。
- statusDescription
- String
關閉作業的狀態訊息。
- cancellationToken
- CancellationToken
會取消暫止作業的物件。
傳回
作業的參考。
例外狀況
之前已處置物件。
解除標記已取消。 此例外狀況會儲存在傳回的工作中。
備註
您可以針對用戶端起始和伺服器起始的要求使用 CloseAsync 和 CloseOutputAsync 方法,以關閉 AspNetWebSocket 連線。 這兩種方法會以相同方式處理用戶端起始的要求:在用戶端傳送訊息至伺服器以關閉連線之後,伺服器會呼叫下列其中一種方法,並將通知傳送給用戶端,然後傳回 方法。
對於伺服器起始的要求,這兩種方法的運作方式不同。 方法 CloseAsync 會將訊息傳送至用戶端以關閉連線、等候回應,然後傳回 。 伺服器不會等候用戶端傳送的任何其他資料。 相反地,方法會將 CloseOutputAsync 訊息傳送至用戶端以關閉連線並傳回,而不需等候回應。 方法傳回之後,您可以呼叫 ReceiveAsync 方法,並處理用戶端傳送的其他資料或通知。