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

ISubscriptionToken 物件，代表 OnSendingHeaders 虛擬事件的訂閱。

備註

重要

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

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

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

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

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

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

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

適用於