HttpResponse.ClientDisconnectedToken プロパティ

定義

名前空間:

System.Web

アセンブリ:

System.Web.dll

クライアントの接続が切断されるとトリップされる CancellationToken オブジェクトを取得します。

public:
 property System::Threading::CancellationToken ClientDisconnectedToken { System::Threading::CancellationToken get(); };

public System.Threading.CancellationToken ClientDisconnectedToken { get; }

member this.ClientDisconnectedToken : System.Threading.CancellationToken

Public ReadOnly Property ClientDisconnectedToken As CancellationToken

プロパティ値

CancellationToken

キャンセル トークン。

注釈

この API はスレッド セーフです。 ただし、キャンセル トークンの使用方法にはいくつかの制限があります。 誤って使用すると、競合状態、デッドロック、またはその他の予期しない動作が発生する可能性があります。 次のガイドラインに注意してください。

• ASP.NET は要求の最後にキャンセル トークンを破棄するため、1 つの要求の範囲外でこの API を呼び出さないようにします。 トークンが破棄される前に、トークンが取り消された状態に遷移する保証はありません。 たとえば、クライアントが切断されずに要求が完了した場合、トークンは最初に取り消されずに破棄されます。

• 非同期通知の目的が CancellationToken.WaitHandle無効になり、デッドロックが発生する可能性があるため、 を待機しないでください。

• 元SynchronizationContextのオブジェクトでコールバックをCancellationToken.Register呼び出すオーバーロードを呼び出さないでください。

• メソッドに提供される HttpContext コールバック内から、オブジェクトまたはその他のスレッド セーフでない ASP.NET 組み込みオブジェクトを CancellationToken.Register 使用しないでください。 コールバックは、他の ASP.NET またはアプリケーション コードと同時に実行されている可能性があります。

• コールバック メソッドの実行時間が短く、ブロックされないようにします。

• コールバック メソッド内から例外がスローされないように、あらゆる努力を行います。

このプロパティは、統合モードのインターネット インフォメーション サービス (IIS) 7.5 以降でのみサポートされます。 適切な IIS バージョンまたはパイプライン モードなしで呼び出すと、 PlatformNotSupportedException がスローされます。 IIS のバージョンを確認するには、 を使用します IISVersion。 パイプライン モードを確認するには、 を使用 UsingIntegratedPipelineします。