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 que les en-têtes de réponse ne soient envoyés pour 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

Renvoie un ISubscriptionToken objet qui représente l’abonnement à l’événement pseudo OnSendingHeaders.

Remarques

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

• Cette méthode est effective uniquement lorsque 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 au sujet du 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 en cours d’exécution. 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 court-en cours d’exécution. La tentative d’appel d’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.