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 ，因為該方法可能會操作回應實體主體。

  • 回呼必須只包含短期執行的同步程式碼。 嘗試叫用非同步作業或等候這類作業可能會導致死結。

  • 回呼不得擲回例外狀況;否則行為未定義。

適用於