HttpResponseBase.AddOnSendingHeaders(Action<HttpContextBase>) 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:
 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

Paramètres

callback

Action<HttpContextBase>

Méthode de rappel.

Retours

ISubscriptionToken

Retourne un objet ISubscriptionToken qui représente l’abonnement au pseudo-événement OnSendingHeaders.

Remarques

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 remarques d’utilisation et mises en garde :

• Cette méthode est efficace uniquement quand IIS s’exécute dans le 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 concernant le thread sur lequel le rappel est appelé. Par exemple, le rappel peut être appelé de façon 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 appeler aucune méthode qui manipule le corps de l’entité de réponse ou qui entraîne un 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 à exécution courte. Toute tentative d’appel d’une opération asynchrone ou d’attente sur 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.