HttpResponseBase.AddOnSendingHeaders(Action<HttpContextBase>) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Regista um callback que o runtime ASP.NET invocará imediatamente antes de serem enviados cabeçalhos de resposta para este pedido.
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.ISubscriptionTokenPublic Overridable Function AddOnSendingHeaders (callback As Action(Of HttpContextBase)) As ISubscriptionTokenParâmetros
- callback
- Action<HttpContextBase>
O método do callback.
Devoluções
Devolve um ISubscriptionToken objeto que representa a subscrição ao pseudo-evento OnSendingHeaders.
Observações
O evento pseudo OnSendingHeaders difere do evento pipeline ao nível do IHttpModule por ser uma subscrição por pedido e não por aplicação. A intenção é que o callback possa modificar o código de estado da resposta ou definir um cookie ou cabeçalho de resposta. Outras notas de uso e ressalvas:
Este método só é eficaz quando o IIS corre em modo pipeline integrado e apenas se os cabeçalhos de resposta ainda não foram enviados para o pedido atual.
O runtime ASP.NET não garante nada sobre o thread onde o callback é invocado. Por exemplo, o callback pode ser invocado de forma síncrona num thread em segundo plano se estiver a ser realizado um flush em segundo plano. Current não é garantido que esteja disponível num tópico deste tipo.
O callback não deve chamar nenhum método que manipule o corpo da entidade de resposta ou que resulte num flush. Por exemplo, o callback não deve chamar Redirect, pois esse método pode manipular o corpo da entidade de resposta.
O callback deve conter apenas código síncrono de curta execução. Tentar invocar uma operação assíncrona ou esperar por tal operação pode resultar num bloqueio.
O callback não pode lançar exceções; caso contrário, o comportamento é indefinido.