AspNetWebSocket.CloseOutputAsync メソッド

定義

名前空間:

System.Web.WebSockets

アセンブリ:

System.Web.dll

クライアントに非同期メッセージを送信して接続を閉じます。 サーバーが接続を閉じる要求を開始する場合、メソッドは応答を待たずに戻ります。

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

保留中の操作を取り消すオブジェクト。

戻り値

Task

操作への参照。

例外

ObjectDisposedException

オブジェクトが既に破棄されています。

InvalidOperationException

AspNetWebSocket オブジェクトは中止状態にあります。

- または -

送信操作を利用できません。

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

クライアント側の CloseAsync 要求とサーバー側の要求の両方に 対して メソッドと CloseOutputAsync メソッドを使用して、接続を AspNetWebSocket 閉じます。 2 つのメソッドは、クライアントによって開始される要求を同じ方法で処理します。クライアントがサーバーにメッセージを送信して接続を閉じると、サーバーはこれらのメソッドのいずれかを呼び出し、クライアントに受信確認を送信し、メソッドから戻ります。

サーバーによって開始される要求の場合、2 つの方法の動作が異なります。 メソッドは CloseAsync 、クライアントにメッセージを送信して接続を閉じ、応答を待機してから、 を返します。 サーバーは、クライアントから送信された追加データを待機しません。 これに対し、 メソッドは CloseOutputAsync クライアントにメッセージを送信して接続を閉じ、応答を待たずに を返します。 メソッドが戻ったら、 メソッドを ReceiveAsync 呼び出して、追加のデータまたはクライアントが送信する受信確認を処理できます。