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 aufruft, bevor Antwortheader für diese Anforderung gesendet werden.
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 das Abonnement für das OnSendingHeaders-Pseudoereignis darstellt.
Hinweise
Important
Die AddOnSendingHeaders-Methode wird nicht aufgerufen, wenn das systemeigene Modul die Antwort zuerst löscht.
Das Pseudoereignis OnSendingHeaders unterscheidet sich von dem Pipelineereignis auf IHttpModule-Ebene darin, dass es sich um ein Abonnement pro Anforderung anstelle eines Abonnements pro Anwendung handelt. Die Absicht besteht darin, dass der Rückruf den Antwortstatuscode ändern oder ein Antwortcookies oder -header festlegen kann. Andere Nutzungsnotizen und Vorbehalte:
Diese Methode ist nur wirksam, wenn IIS in der Pipeline für den integrierten Pipelinemodus ausgeführt wird und nur, wenn Antwortheader noch nicht für die aktuelle Anforderung gesendet wurden.
Die ASP.NET Laufzeit 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 Hintergrundspülung ausgeführt wird. Current ist nicht garantiert, dass sie in einem solchen Thread verfügbar sind.
Der Rückruf darf keine Methode aufrufen, die den Textkörper der Antwortentität bearbeitet oder die zu einem Leeren führt. Beispielsweise darf der Rückruf nicht aufgerufen werden Redirect, da diese Methode den Textkörper der Antwortentität ändern 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.