Compartir a través de


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

Definición

Registra una devolución de llamada que el runtime de ASP.NET invocará inmediatamente antes de enviar los encabezados de respuesta para esta solicitud.

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>

Método de devolución de llamada.

Devoluciones

ISubscriptionToken

Objeto ISubscriptionToken que representa la suscripción al pseudoevento OnSendingHeaders.

Comentarios

Importante

El método AddOnSendingHeaders no se invoca si el módulo nativo vacía primero la respuesta.

El pseudo-event OnSendingHeaders difiere del evento de canalización de nivel IHttpModule en que es una suscripción por solicitud en lugar de una suscripción por aplicación. La intención es que la devolución de llamada pueda modificar el código de estado de respuesta o puede establecer una cookie o encabezado de respuesta. Otras notas de uso y advertencias:

  • Este método solo es eficaz cuando IIS se ejecuta en la canalización del modo de canalización integrada y solo si los encabezados de respuesta aún no se han enviado para la solicitud actual.

  • El tiempo de ejecución de ASP.NET no garantiza nada sobre el subproceso en el que se invoca la devolución de llamada. Por ejemplo, la devolución de llamada se puede invocar de forma sincrónica en un subproceso en segundo plano si se realiza un vaciado en segundo plano. Current no se garantiza que esté disponible en este subproceso.

  • La devolución de llamada no debe llamar a ningún método que manipule el cuerpo de la entidad de respuesta o que produzca un vaciado. Por ejemplo, la devolución de llamada no debe llamar a Redirect, ya que ese método puede manipular el cuerpo de la entidad de respuesta.

  • La devolución de llamada solo debe contener código sincrónico de ejecución corta. Si se intenta invocar una operación asincrónica o esperar en esta operación, se podría producir un interbloqueo.

  • La devolución de llamada no debe producir una excepción; de lo contrario, el comportamiento no está definido.

Se aplica a