HttpResponse.AddOnSendingHeaders(Action<HttpContext>) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.ISubscriptionTokenPublic Function AddOnSendingHeaders (callback As Action(Of HttpContext)) As ISubscriptionTokenParameter
- 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.
