HttpResponse.AddOnSendingHeaders(Action<HttpContext>) HttpResponse.AddOnSendingHeaders(Action<HttpContext>) HttpResponse.AddOnSendingHeaders(Action<HttpContext>) HttpResponse.AddOnSendingHeaders(Action<HttpContext>) Method

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.Registers a callback that the ASP.NET runtime will invoke immediately before response headers are sent for this request.

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.The callback method.

Devoluciones

Objeto ISubscriptionToken que representa la suscripción al pseudoevento OnSendingHeaders.An ISubscriptionToken object that represents the subscription to the OnSendingHeaders pseudo-event.

Comentarios

Importante

El método AddOnSendingHeaders no se invoca si el módulo nativo vacía primero la respuesta.The AddOnSendingHeaders method is not invoked if the native module flushes the response first.

El Pseudoevento onsendingheaders de pseudo eventos difiere del evento de canalización de nivel de IHttpModule en que es una suscripción por solicitud en lugar de una suscripción por aplicación.The pseudo-event OnSendingHeaders differs from the IHttpModule-level pipeline event in that it is a per-request subscription rather than a per-application subscription. La intención es que la devolución de llamada pueda modificar el código de estado de la respuesta o puede establecer un encabezado o una cookie de respuesta.The intent is that the callback may modify the response status code or may set a response cookie or header. Otras notas de uso y advertencias:Other usage notes and caveats:

  • Este método solo es eficaz cuando IIS se ejecuta en una canalización en modo de canalización integrada y solo si todavía no se han enviado encabezados de respuesta para la solicitud actual.This method is effective only when IIS runs in integrated pipeline mode pipeline and only if response headers haven't yet been sent for the current request.

  • El tiempo de ejecución de ASP.NET no garantiza nada sobre el subproceso en el que se invoca la devolución de llamada.The ASP.NET runtime does not guarantee anything about the thread that the callback is invoked on. Por ejemplo, la devolución de llamada se puede invocar sincrónicamente en un subproceso en segundo plano si se está realizando un vaciado de fondo.For example, the callback may be invoked synchronously in a background thread if a background flush is being performed. Currentno se garantiza que esté disponible en este tipo de subproceso.Current is not guaranteed to be available in such a thread.

  • La devolución de llamada no debe llamar a ningún método que manipule el cuerpo de la entidad de respuesta o que dé lugar a un vaciado.The callback must not call any method that manipulates the response entity body or that results in a flush. Por ejemplo, la devolución de llamada no Redirectdebe llamar a, ya que ese método puede manipular el cuerpo de la entidad de respuesta.For example, the callback must not call Redirect, as that method may manipulate the response entity body.

  • La devolución de llamada solo debe contener código sincrónico de breve ejecución.The callback must contain only short-running synchronous code. Si se intenta invocar una operación asincrónica o esperar en una operación de este tipo, se podría producir un interbloqueo.Attempting to invoke an asynchronous operation or wait on such an operation could result in a deadlock.

  • La devolución de llamada no debe producir una excepción; de lo contrario, el comportamiento es indefinido.The callback must not throw an exception; otherwise behavior is undefined.

Se aplica a