HttpResponseBase.AddOnSendingHeaders(Action<HttpContextBase>) Methode

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

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

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

Parameter

callback

Action<HttpContextBase>

Die Rückrufmethode.

Gibt zurück

ISubscriptionToken

Gibt ein ISubscriptionToken-Objekt zurück, das ein Abonnement für das OnSendingHeaders-Pseudoereignis darstellt.

Hinweise

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.