Freigeben über


HttpResponse.AddOnSendingHeaders(Action<HttpContext>) Methode

Definition

Registriert einen Rückruf, den die ASP.NET-Laufzeit unmittelbar vor dem Senden der Antwortheader für diese Anforderung aufruft.

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

Parameter

callback
Action<HttpContext>

Die Rückrufmethode.

Gibt zurück

Ein ISubscriptionToken-Objekt, das ein Abonnement für das OnSendingHeaders-Pseudoereignis darstellt.

Hinweise

Wichtig

Die AddOnSendingHeaders-Methode wird nicht aufgerufen, wenn das native Modul zuerst die Antwort leert.

Das Pseudoereignis OnSendingHeaders unterscheidet sich vom Pipelineereignis auf IHttpModule-Ebene darin, dass es sich um ein Abonnement pro Anforderung und nicht um ein Abonnement pro Anwendung handelt. Die Absicht besteht darin, dass der Rückruf den Antwortstatuscode ändern oder ein Antwortcookies oder -header festlegen kann. Weitere Nutzungshinweise und Einschränkungen:

  • Diese Methode ist nur wirksam, wenn IIS in einer Pipeline im integrierten Pipelinemodus ausgeführt wird, und nur, wenn noch keine Antwortheader für die aktuelle Anforderung gesendet wurden.

  • Die ASP.NET Runtime garantiert nichts über den Thread, für den der Rückruf aufgerufen wird. Beispielsweise kann der Rückruf synchron in einem Hintergrundthread aufgerufen werden, wenn eine Hintergrundleerung ausgeführt wird. Current ist nicht garantiert, dass sie in einem solchen Thread verfügbar ist.

  • Der Rückruf darf keine Methode aufrufen, die den Antwortentitätstext bearbeitet oder zu einer Leerung führt. Beispielsweise darf der Rückruf nicht aufrufen Redirect, da diese Methode den Antwortentitätstext bearbeiten kann.

  • Der Rückruf darf nur kurz ausgeführten synchronen Code enthalten. Der Versuch, einen asynchronen Vorgang aufzurufen oder auf einen solchen Vorgang zu warten, kann zu einem Deadlock führen.

  • Der Rückruf darf keine Ausnahme auslösen. Andernfalls ist das Verhalten nicht definiert.

Gilt für: