HttpResponse.AddOnSendingHeaders(Action<HttpContext>) Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Zaregistruje zpětné volání, které modul runtime ASP.NET vyvolá bezprostředně před odesláním hlaviček odpovědi na tento požadavek.

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

Parametry

callback

Action<HttpContext>

Metoda zpětného volání.

Návraty

ISubscriptionToken

Objekt ISubscriptionToken , který představuje odběr OnSendingHeaders pseudo-události.

Poznámky

Důležité

AddOnSendingHeaders Metoda není vyvolána, pokud nativní modul vyprázdní odpověď jako první.

Pseudo událost OnSendingHeaders se liší od události kanálu na úrovni IHttpModule v tom, že se jedná o odběr pro jednotlivé požadavky, nikoli o předplatné pro jednotlivé aplikace. Záměrem je, že zpětné volání může změnit stavový kód odpovědi nebo nastavit soubor cookie nebo hlavičku odpovědi. Další poznámky k použití a upozornění:

• Tato metoda je účinná pouze v případě, že služba IIS běží v kanálu v integrovaném režimu kanálu a pouze v případě, že hlavičky odpovědi ještě nebyly odeslány pro aktuální požadavek.

• Modul runtime ASP.NET nezaručuje nic o vlákně, na které je zpětné volání vyvoláno. Například zpětné volání může být vyvoláno synchronně ve vlákně na pozadí, pokud se provádí vyprázdnění pozadí. Current není zaručeno, že bude v takovém vlákně k dispozici.

• Zpětné volání nesmí volat žádnou metodu, která manipuluje s tělem entity odpovědi nebo která má za následek vyprázdnění. Zpětné volání například nesmí volat Redirect, protože tato metoda může manipulovat s tělem entity odpovědi.

• Zpětné volání musí obsahovat pouze krátce běžící synchronní kód. Pokus o vyvolání asynchronní operace nebo čekání na takovou operaci může vést ke vzájemnému zablokování.

• Zpětné volání nesmí vyvolat výjimku; v opačném případě není definováno chování.