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

表示对 OnSendingHeaders 伪事件的订阅的 ISubscriptionToken 对象。

注解

重要

如果本机模块先刷新响应，则不会调用 AddOnSendingHeaders 方法。

伪事件 OnSendingHeaders 不同于 IHttpModule 级管道事件，因为它是每个请求订阅，而不是每个应用程序订阅。 意图是回调可以修改响应状态代码，也可以设置响应 Cookie 或标头。 其他用法说明和注意事项：

  • 仅当 IIS 在集成管道模式管道中运行并且仅当尚未为当前请求发送响应标头时，此方法才有效。

  • ASP.NET 运行时不能保证调用回调的线程的任何内容。 例如，如果在执行后台刷新，可以在后台线程中同步调用回调。 Current 不能保证在此类线程中可用。

  • 回调不得调用任何操作响应实体正文或导致刷新的方法。 例如，回调不得调用 Redirect，因为该方法可以操作响应实体正文。

  • 回调必须仅包含短运行的同步代码。 尝试调用异步操作或等待此类操作可能会导致死锁。

  • 回调不得引发异常;否则行为未定义。

适用于