HttpResponse.AddOnSendingHeaders(Action<HttpContext>) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Registreert een callback die door de ASP.NET runtime direct wordt aangeroepen voordat antwoordheaders voor deze aanvraag worden verzonden.
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.ISubscriptionTokenPublic Function AddOnSendingHeaders (callback As Action(Of HttpContext)) As ISubscriptionTokenParameters
- callback
- Action<HttpContext>
De callback-methode.
Retouren
Een ISubscriptionToken object dat het abonnement vertegenwoordigt op de pseudogebeurtenis OnSendingHeaders.
Opmerkingen
Important
De methode AddOnSendingHeaders wordt niet aangeroepen als de systeemeigen module het antwoord eerst leeg maakt.
De pseudogebeurtenis OnSendingHeaders verschilt van de pijplijngebeurtenis op IHttpModule-niveau omdat het een abonnement per aanvraag is in plaats van een abonnement per toepassing. De bedoeling is dat de callback de antwoordstatuscode kan wijzigen of een antwoordcooky of header kan instellen. Andere gebruiksopmerkingen en opmerkingen bij het gebruik:
Deze methode is alleen van kracht wanneer IIS wordt uitgevoerd in de pijplijn voor de geïntegreerde pijplijnmodus en alleen als antwoordheaders nog niet zijn verzonden voor de huidige aanvraag.
De ASP.NET runtime garandeert niets over de thread waarop de callback wordt aangeroepen. De callback kan bijvoorbeeld synchroon worden aangeroepen in een achtergrondthread als er een achtergrondspoeling wordt uitgevoerd. Current is niet gegarandeerd beschikbaar in een dergelijke thread.
De callback mag geen methode aanroepen die de hoofdtekst van de antwoordentiteit bewerkt of die resulteert in een leegmaken. De callback mag bijvoorbeeld niet worden aangeroepen Redirect, omdat deze methode de hoofdtekst van de antwoordentiteit kan manipuleren.
De callback mag alleen kortlopende synchrone code bevatten. Een poging om een asynchrone bewerking aan te roepen of te wachten op een dergelijke bewerking kan leiden tot een impasse.
De callback mag geen uitzondering genereren; anders is het gedrag niet gedefinieerd.