HttpResponseBase.AddOnSendingHeaders(Action<HttpContextBase>) Metodo

Definizione

Spazio dei nomi:

System.Web

Assembly:

System.Web.dll

Registra un callback che verrà richiamato dal runtime ASP.NET immediatamente prima che le intestazioni di risposta vengano inviate per questa richiesta.

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

Parametri

callback

Action<HttpContextBase>

Metodo di callback.

Restituisce

ISubscriptionToken

Restituisce un oggetto ISubscriptionToken che rappresenta la sottoscrizione dello pseudoevento OnSendingHeaders.

Commenti

L'evento pseudo OnSendingHeaders differisce dall'evento della pipeline A livello di IHttpModule in cui è una sottoscrizione per richiesta anziché una sottoscrizione per ogni applicazione. La finalità è che il callback può modificare il codice di stato della risposta o può impostare un cookie o un'intestazione di risposta. Altre note sull'utilizzo e le avvertenze:

• Questo metodo è efficace solo quando IIS viene eseguito nella pipeline in modalità pipeline integrata e solo se le intestazioni di risposta non sono ancora state inviate per la richiesta corrente.

• Il runtime di ASP.NET non garantisce alcun elemento sul thread in cui viene richiamato il callback. Ad esempio, il callback può essere richiamato in modo sincrono in un thread in background se viene eseguito uno scarico in background. Current non è garantito che sia disponibile in un thread di questo tipo.

• Il callback non deve chiamare alcun metodo che modifica il corpo dell'entità risposta o che genera uno scaricamento. Ad esempio, il callback non deve chiamare Redirect, perché tale metodo può modificare il corpo dell'entità risposta.

• Il callback deve contenere solo codice sincrono a esecuzione breve. Il tentativo di richiamare un'operazione asincrona o attendere su tale operazione potrebbe causare un deadlock.

• Il callback non deve generare un'eccezione; in caso contrario, il comportamento non è definito.