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

Définition

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

Paramètres

callback
Action<HttpContext>

Méthode de rappel.The callback method.

Retours

Objet ISubscriptionToken qui représente l'abonnement au pseudo-événement OnSendingHeaders.An ISubscriptionToken object that represents the subscription to the OnSendingHeaders pseudo-event.

Remarques

Important

La méthode AddOnSendingHeaders n’est pas appelée si le module natif vide la réponse tout d’abord.The AddOnSendingHeaders method is not invoked if the native module flushes the response first.

Le pseudo-événement onsendingheaders diffère de l’événement de pipeline IHttpModule : c’est un abonnement par demande plutôt que d’un abonnement par application.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. L’objectif est que le rappel peut modifier le code d’état de réponse ou peut définir un en-tête ou un cookie de réponse.The intent is that the callback may modify the response status code or may set a response cookie or header. Autres remarques sur l’utilisation et les mises en garde :Other usage notes and caveats:

  • Cette méthode est effective uniquement lorsque IIS s’exécute dans le pipeline de 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.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.

  • Le runtime ASP.NET ne garantit pas quoi que ce soit sur le thread qui le rappel est appelé sur.The ASP.NET runtime does not guarantee anything about the thread that the callback is invoked on. 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.For example, the callback may be invoked synchronously in a background thread if a background flush is being performed. Current n’est pas garanti pour être disponible dans un thread de ce type.Current is not guaranteed to be available in such a thread.

  • Le rappel ne doit pas appeler toute méthode qui manipule le corps d’entité de réponse ou qui entraîne un vidage.The callback must not call any method that manipulates the response entity body or that results in a flush. Par exemple, le rappel ne doit pas appeler Redirect, comme cette méthode peut manipuler le corps d’entité de réponse.For example, the callback must not call Redirect, as that method may manipulate the response entity body.

  • Le rappel doit contenir uniquement du code synchrone courte.The callback must contain only short-running synchronous code. Tente d’appeler une opération asynchrone ou attendre une telle opération peut provoquer un interblocage.Attempting to invoke an asynchronous operation or wait on such an operation could result in a deadlock.

  • Le rappel ne doit pas lever d’exception ; Sinon, le comportement est indéfini.The callback must not throw an exception; otherwise behavior is undefined.

S’applique à