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

Définition

Espace de noms:

System.Web

Assembly:

System.Web.dll

Inscrit un rappel que le runtime ASP.NET appelle immédiatement avant l'envoi des en-têtes de réponse correspondant à cette requête.

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

Paramètres

callback

Action<HttpContext>

Méthode de rappel.

Retours

ISubscriptionToken

Objet ISubscriptionToken qui représente l'abonnement au pseudo-événement OnSendingHeaders.

Remarques

Important

La méthode AddOnSendingHeaders n’est pas appelée si le module natif vide d’abord la réponse.

Le pseudo-événement OnSendingHeaders diffère de l’événement de pipeline de niveau IHttpModule en ce qu’il s’agit d’un abonnement par demande plutôt que d’un abonnement par application. L’intention est que le rappel puisse modifier le code d’état de la réponse ou définir un cookie ou un en-tête de réponse. Autres notes d’utilisation et mises en garde :

• Cette méthode n’est effective que lorsque IIS s’exécute dans un pipeline en mode pipeline intégré et uniquement si les en-têtes de réponse n’ont pas encore été envoyés pour la requête actuelle.

• Le runtime ASP.NET ne garantit rien au sujet du thread sur lequel le rappel est appelé. Par exemple, le rappel peut être appelé de manière synchrone dans un thread d’arrière-plan si un vidage d’arrière-plan est effectué. Current n’est pas garanti d’être disponible dans un tel thread.

• Le rappel ne doit pas appeler une méthode qui manipule le corps de l’entité de réponse ou qui entraîne une vidage. Par exemple, le rappel ne doit pas appeler Redirect, car cette méthode peut manipuler le corps de l’entité de réponse.

• Le rappel doit contenir uniquement du code synchrone à court terme. La tentative d’appeler une opération asynchrone ou d’attendre une telle opération peut entraîner un blocage.

• Le rappel ne doit pas lever d’exception ; sinon, le comportement n’est pas défini.