HttpResponseBase.AddOnSendingHeaders(Action<HttpContextBase>) Metod

Definition

Namnområde:
System.Web
Sammansättning:
System.Web.dll

Registrerar ett återanrop som ASP.NET-körningen anropar omedelbart innan svarshuvudena skickas för den här begäran.

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

Parametrar

callback
Action<HttpContextBase>

Återanropsmetoden.

Returer

ISubscriptionToken

Returnerar ett ISubscriptionToken objekt som representerar prenumerationen till pseudohändelsen OnSendingHeaders.

Kommentarer

Pseudohändelsen OnSendingHeaders skiljer sig från pipelinehändelsen på IHttpModule-nivå eftersom det är en prenumeration per begäran i stället för en prenumeration per program. Avsikten är att återanropet kan ändra svarsstatuskoden eller ange en svarscookie eller rubrik. Andra användningsanteckningar och varningar:

  • Den här metoden är endast effektiv när IIS körs i en pipeline i integrerat pipelineläge och endast om svarshuvuden ännu inte har skickats för den aktuella begäran.

  • ASP.NET-körningen garanterar inte något om tråden som återanropet anropas på. Motringningen kan till exempel anropas synkront i en bakgrundstråd om en bakgrundsspolning utförs. Current är inte garanterad att vara tillgänglig i en sådan tråd.

  • Återanropet får inte anropa någon metod som manipulerar svarsentitetens brödtext eller som resulterar i en tömning. Motringningen får till exempel inte anropa Redirect, eftersom den metoden kan manipulera svarsentitetens brödtext.

  • Återanropet får endast innehålla kortkörande synkron kod. Om du försöker anropa en asynkron åtgärd eller vänta på en sådan åtgärd kan det leda till ett dödläge.

  • Återanropet får inte utlösa ett undantag. annars är beteendet odefinierat.

Gäller för