HttpResponseBase.AddOnSendingHeaders(Action<HttpContextBase>) 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:
 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

Parametry

callback

Action<HttpContextBase>

Metoda zpětného volání.

Návraty

ISubscriptionToken

ISubscriptionToken Vrátí objekt, který představuje odběr onSendingHeaders pseudo událost.

Poznámky

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 odběr pro jednotlivé aplikace. Záměrem je, že zpětné volání může upravit 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 platná pouze v případě, že služba IIS běží v kanálu integrovaného 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 vyvoláno zpětné volání. 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 v takovém vlákně není zaručeno, že bude 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í. Například zpětné volání 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 k zablokování.

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