HttpResponseBase.AddOnSendingHeaders(Action<HttpContextBase>) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Registra um retorno de chamada que o runtime ASP.NET invocará imediatamente antes que os cabeçalhos de resposta sejam enviados para essa solicitação.
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 de retorno de chamada.
Retornos
Retorna um ISubscriptionToken objeto que representa a assinatura do pseudo-evento OnSendingHeaders.
Comentários
O pseudo-evento OnSendingHeaders difere do evento de pipeline no nível de 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ó será eficaz quando o IIS for 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 poderá 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 é garantido que esteja 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 um código síncrono de execução curta. A tentativa de 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.