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

回傳 ISubscriptionToken 一個物件，代表對 OnSendingHeaders 偽事件的訂閱。

備註

偽事件 OnSendingHeaders 與 IHttpModule 層級的管線事件不同，因為它是按請求訂閱，而非按應用程式訂閱。 其目的是回調可以修改回應狀態碼，或設定回應 cookie 或標頭。 其他用法說明與注意事項：

  • 此方法僅在 IIS 以整合管線模式執行且尚未發送回應標頭時有效。

  • ASP.NET 執行時並不保證呼叫回調所使用的執行緒有任何資訊。 例如，若背景執行緒正在進行背景沖洗，回調可在背景執行緒中同步呼叫。 Current 不保證會在此類討論串中找到。

  • 回調不得呼叫任何操作回應實體體或導致刷新的方法。 例如，回調不得呼叫 Redirect，因為該方法可能會操作回應實體的實體。

  • 回調必須只包含短時間執行的同步程式碼。 嘗試呼叫非同步操作或等待該操作可能導致死結。

  • 回調不得拋出例外;否則行為未定義。

適用於