HttpResponseBase.AddOnSendingHeaders(Action<HttpContextBase>) Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

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:
 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.ISubscriptionToken

Public Overridable Function AddOnSendingHeaders (callback As Action(Of HttpContextBase)) As ISubscriptionToken

Parámetros

callback

Action<HttpContextBase>

Método de devolución de llamada.

Devoluciones

ISubscriptionToken

Devuelve un objeto ISubscriptionToken que representa la suscripción al seudoevento OnSendingHeaders.

Comentarios

El pseudo evento 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 entorno 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.