HttpResponse.AddOnSendingHeaders(Action<HttpContext>) Metodo

Definizione

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

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

Parametri

callback
Action<HttpContext>

Metodo di callback.

Restituisce

Oggetto ISubscriptionToken che rappresenta la sottoscrizione dello pseudoevento OnSendingHeaders.

Commenti

Importante

Il metodo AddOnSendingHeaders non viene richiamato se il modulo nativo scarica prima la risposta.

Lo pseudo-evento OnSendingHeaders differisce dall'evento della pipeline AhttpModule in quanto si tratta di una sottoscrizione per richiesta anziché di una sottoscrizione per applicazione. La finalità è che il callback può modificare il codice di stato della risposta o impostare un cookie o un'intestazione di risposta. Altre note sull'utilizzo e avvertenze:

  • Questo metodo è valido 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 ASP.NET non garantisce nulla sul thread su cui viene richiamato il callback. Ad esempio, il callback può essere richiamato in modo sincrono in un thread in background se viene eseguito uno scaricamento dello sfondo. 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à di risposta o che restituisce uno scaricamento. Ad esempio, il callback non deve chiamare Redirect, perché tale metodo può modificare il corpo dell'entità di risposta.

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

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

Si applica a