HttpResponse.AddOnSendingHeaders(Action<HttpContext>) メソッド

定義

名前空間:
System.Web
アセンブリ:
System.Web.dll

ASP.NET ランタイムがこの要求に対して応答ヘッダーを送信する直前に呼び出すコールバックを登録します。

public:
 System::Web::ISubscriptionToken ^ AddOnSendingHeaders(Action<System::Web::HttpContext ^> ^ callback);
public System.Web.ISubscriptionToken AddOnSendingHeaders(Action<System.Web.HttpContext> callback);
member this.AddOnSendingHeaders : Action<System.Web.HttpContext> -> System.Web.ISubscriptionToken
Public Function AddOnSendingHeaders (callback As Action(Of HttpContext)) As ISubscriptionToken

パラメーター

callback
Action<HttpContext>

コールバック メソッド。

返品

ISubscriptionToken

OnSendingHeaders 擬似イベントへのサブスクリプションを表す ISubscriptionToken オブジェクト。

注釈

Important

ネイティブ モジュールが最初に応答をフラッシュした場合、AddOnSendingHeaders メソッドは呼び出されません。

擬似イベント OnSendingHeaders は、IHttpModule レベルのパイプライン イベントとは異なり、アプリケーションごとのサブスクリプションではなく、要求ごとのサブスクリプションです。 目的は、コールバックが応答状態コードを変更したり、応答 Cookie またはヘッダーを設定したりする可能性があるということです。 その他の使用上の注意事項:

  • このメソッドは、IIS が統合パイプライン モードのパイプラインで実行されている場合、および現在の要求に対して応答ヘッダーがまだ送信されていない場合にのみ有効です。

  • ASP.NET ランタイムは、コールバックが呼び出されるスレッドについて何も保証しません。 たとえば、バックグラウンド フラッシュが実行されている場合、バックグラウンド スレッドでコールバックを同期的に呼び出すことができます。 Current は、このようなスレッドで使用できる保証はありません。

  • コールバックは、応答エンティティ本体を操作するメソッド、またはフラッシュを発生するメソッドを呼び出してはなりません。 たとえば、コールバックは応答エンティティ本体を操作する可能性があるため、 Redirectを呼び出してはなりません。

  • コールバックには、実行時間の短い同期コードのみを含む必要があります。 非同期操作を呼び出そうとしたり、そのような操作を待機しようとすると、デッドロックが発生する可能性があります。

  • コールバックは例外をスローしてはなりません。それ以外の場合の動作は未定義です。

適用対象