共用方式為


HttpResponse.AddOnSendingHeaders(Action<HttpContext>) 方法

定義

註冊 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 虛擬事件的訂閱。

備註

重要

如果原生模組先排清回應,則不會叫用 AddOnSendingHeaders 方法。

虛擬事件 OnSendingHeaders 與 IHttpModule 層級管線事件不同,因為它是個別要求訂閱,而不是個別應用程式訂用帳戶。 意圖是回呼可能會修改回應狀態碼,也可以設定回應 Cookie 或標頭。 其他使用注意事項和注意事項:

  • 只有在 IIS 在整合式管線模式管線中執行,而且只有在尚未針對目前要求傳送回應標頭時,這個方法才有效。

  • ASP.NET 執行時間不保證叫用回呼的執行緒相關任何專案。 例如,如果執行背景排清,可以在背景執行緒中同步叫用回呼。 Current 不保證可在這類執行緒中使用。

  • 回呼不得呼叫任何操作回應實體主體或導致排清的方法。 例如,回呼不得呼叫 Redirect ,因為該方法可能會操作回應實體主體。

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

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

適用於