HttpResponseBase.AddOnSendingHeaders(Action<HttpContextBase>) メソッド

定義

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

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

public:
 virtual System::Web::ISubscriptionToken ^ AddOnSendingHeaders(Action<System::Web::HttpContextBase ^> ^ callback);
public virtual System.Web.ISubscriptionToken AddOnSendingHeaders(Action<System.Web.HttpContextBase> callback);
abstract member AddOnSendingHeaders : Action<System.Web.HttpContextBase> -> System.Web.ISubscriptionToken
override this.AddOnSendingHeaders : Action<System.Web.HttpContextBase> -> System.Web.ISubscriptionToken
Public Overridable Function AddOnSendingHeaders (callback As Action(Of HttpContextBase)) As ISubscriptionToken

パラメーター

callback
Action<HttpContextBase>

コールバック メソッド。

返品

ISubscriptionToken

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

注釈

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

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

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

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

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

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

適用対象