HttpResponse.AddOnSendingHeaders(Action<HttpContext>) Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

Registra um retorno de chamada que o runtime do ASP.NET invocará imediatamente antes dos cabeçalhos de resposta serem enviados para esta solicitação.

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

Parâmetros

callback

Action<HttpContext>

O método de retorno de chamada.

Retornos

ISubscriptionToken

Um objeto ISubscriptionToken que representa a assinatura do pseudoevento OnSendingHeaders.

Comentários

Importante

O método AddOnSendingHeaders não será invocado se o módulo nativo liberar a resposta primeiro.

O pseudo-evento OnSendingHeaders difere do evento de pipeline no nível IHttpModule, pois ele é uma assinatura por solicitação em vez de uma assinatura por aplicativo. A intenção é que o retorno de chamada possa modificar o código de status da resposta ou pode definir um cookie de resposta ou cabeçalho. Outras anotações de uso e advertências:

• Esse método só é eficaz quando o IIS é executado no pipeline do modo de pipeline integrado e somente se os cabeçalhos de resposta ainda não tiverem sido enviados para a solicitação atual.

• O runtime ASP.NET não garante nada sobre o thread no qual o retorno de chamada é invocado. Por exemplo, o retorno de chamada pode ser invocado de forma síncrona em um thread em segundo plano se uma liberação de plano de fundo estiver sendo executada. Current não tem a garantia de estar disponível nesse thread.

• O retorno de chamada não deve chamar nenhum método que manipule o corpo da entidade de resposta ou que resulte em uma liberação. Por exemplo, o retorno de chamada não deve chamar Redirect, pois esse método pode manipular o corpo da entidade de resposta.

• O retorno de chamada deve conter apenas código síncrono de execução curta. Tentar invocar uma operação assíncrona ou aguardar tal operação pode resultar em um deadlock.

• O retorno de chamada não deve gerar uma exceção; caso contrário, o comportamento é indefinido.