HttpResponse.AddOnSendingHeaders(Action<HttpContext>) Metódus

Definíció

Névtér:

System.Web

Szerelvény:

System.Web.dll

Regisztrál egy visszahívást, amelyet a ASP.NET futtatókörnyezet közvetlenül a kérés válaszfejléceinek elküldése előtt hív meg.

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

Paraméterek

callback

Action<HttpContext>

A visszahívási módszer.

Válaszok

ISubscriptionToken

Az ISubscriptionToken OnSendingHeaders pseudo-event előfizetését jelképező objektum.

Megjegyzések

Important

Az AddOnSendingHeaders metódus nem hívható meg, ha a natív modul először kiüríti a választ.

Az OnSendingHeaders pszeudoesemény abban különbözik az IHttpModule szintű folyamateseménytől, hogy az alkalmazásonkénti előfizetés helyett kérésenkénti előfizetés. A szándék az, hogy a visszahívás módosíthatja a válasz állapotkódját, vagy beállíthat egy válasz cookie-t vagy fejlécet. Egyéb használati megjegyzések és figyelmeztetések:

• Ez a módszer csak akkor érvényes, ha az IIS integrált folyamatmódú folyamatban fut, és csak akkor, ha a válaszfejlécek még nem lettek elküldve az aktuális kéréshez.

• A ASP.NET futtatókörnyezet nem garantál semmit arról a szálról, amelyen a visszahívást meghívják. Előfordulhat például, hogy a visszahívás szinkron módon hívható meg egy háttérszálban, ha háttéröblítés történik. Current nem garantált, hogy ilyen szálon elérhető.

• A visszahívás nem hívhat meg olyan metódust, amely módosítja a válasz entitás törzsét, vagy amely öblítést eredményez. A visszahívás például nem hívható Redirectmeg, mivel ez a módszer módosíthatja a válasz entitás törzsét.

• A visszahívásnak csak rövid ideig futó szinkron kódot kell tartalmaznia. Ha aszinkron műveletet próbál meg meghívni, vagy várni egy ilyen műveletre, az holtponthoz vezethet.

• A visszahívás nem vet ki kivételt; ellenkező esetben a viselkedés nincs meghatározva.