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á okamžitě před odesláním hlaviček odpovědí pro 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-event.

Poznámky

Important

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

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

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

• Modul runtime ASP.NET nezaručuje nic o vlákně, na které je vyvoláno zpětné volání. Zpětné volání se například může vyvolat synchronně ve vlákně na pozadí, pokud probíhá vyprázdnění pozadí. Current není zaručeno, že je 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 zkrácený synchronní kód. Pokus o vyvolání asynchronní operace nebo čekání na takovou operaci může vést k zablokování.

• Zpětné volání nesmí vyvolat výjimku; jinak chování není definováno.