HttpResponse.AddOnSendingHeaders(Action<HttpContext>) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web
Zestaw:
System.Web.dll

Rejestruje wywołanie zwrotne, które środowisko uruchomieniowe ASP.NET wywoła bezpośrednio przed wysłaniem nagłówków odpowiedzi dla tego żądania.

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 wywołania zwrotnego.

Zwraca

ISubscriptionToken

Obiekt ISubscriptionToken reprezentujący subskrypcję pseudo-eventu OnSendingHeaders.

Uwagi

Ważne

Metoda AddOnSendingHeaders nie jest wywoływana, jeśli moduł natywny opróżni najpierw odpowiedź.

Pseudo-event OnSendingHeaders różni się od zdarzenia potoku na poziomie IHttpModule, ponieważ jest to subskrypcja na żądanie, a nie subskrypcja dla aplikacji. Intencją jest to, że wywołanie zwrotne może zmodyfikować kod stanu odpowiedzi lub może ustawić plik cookie lub nagłówek odpowiedzi. Inne uwagi dotyczące użycia i zastrzeżenia:

  • Ta metoda jest skuteczna tylko wtedy, gdy usługi IIS działają w potoku zintegrowanego trybu potoku i tylko wtedy, gdy nagłówki odpowiedzi nie zostały jeszcze wysłane dla bieżącego żądania.

  • Środowisko uruchomieniowe ASP.NET nie gwarantuje nic o wątku wywoływanym przez wywołanie zwrotne. Na przykład wywołanie zwrotne może być wywoływane synchronicznie w wątku w tle, jeśli jest wykonywane opróżnienie tła. Current Nie ma gwarancji, że jest dostępny w takim wątku.

  • Wywołanie zwrotne nie może wywoływać żadnej metody, która manipuluje treścią jednostki odpowiedzi lub powoduje opróżnienie. Na przykład wywołanie zwrotne nie może wywołać metody Redirect, ponieważ ta metoda może manipulować treścią jednostki odpowiedzi.

  • Wywołanie zwrotne musi zawierać tylko krótki synchroniczny kod. Próba wywołania operacji asynchronicznej lub oczekiwania na taką operację może spowodować zakleszczenie.

  • Wywołanie zwrotne nie może zgłaszać wyjątku; w przeciwnym razie zachowanie jest niezdefiniowane.

Dotyczy