HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Metoda

  • Odwołanie

Definicja

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

Umożliwia wstawianie bloków podstawienia odpowiedzi do odpowiedzi, co umożliwia dynamiczne generowanie określonych regionów odpowiedzi dla wyjściowych buforowanych odpowiedzi.

public:
 void WriteSubstitution(System::Web::HttpResponseSubstitutionCallback ^ callback);
public void WriteSubstitution (System.Web.HttpResponseSubstitutionCallback callback);
member this.WriteSubstitution : System.Web.HttpResponseSubstitutionCallback -> unit
Public Sub WriteSubstitution (callback As HttpResponseSubstitutionCallback)

Parametry

callback
HttpResponseSubstitutionCallback

Metoda, kontrolka użytkownika lub obiekt do zastąpienia.

Wyjątki

ArgumentException

Element docelowy parametru callback ma typ Control.

Uwagi

Możesz użyć WriteSubstitution metody podstawiania po pamięci podręcznej na stronach pamięci podręcznej danych wyjściowych. Przekazując HttpContext obiekt do metody wywołania zwrotnego z określonym HttpResponseSubstitutionCallback podpisem, można zastąpić zawartość zapisaną w pamięci podręcznej danych wyjściowych w dowolnej lokalizacji w pamięci podręcznej strony. Aby zainicjować zamianę, wywołaj WriteSubstitution metodę , przekazując ją metodę wywołania zwrotnego, która musi być bezpieczna wątkiem i może być jedną z następujących czynności:

  • Metoda statyczna na stronie kontenera lub kontrolce użytkownika.
  • Metoda statyczna lub wystąpienie na innym dowolnym obiekcie.

Na pierwszym żądaniu na stronie WriteSubstitution wywołuje delegata HttpResponseSubstitutionCallback w celu wygenerowania danych wyjściowych. Następnie dodaje bufor podstawień do odpowiedzi, który zachowuje delegata w celu wywołania przyszłych żądań. Na koniec obniża wydajność pamięci podręcznej po stronie klienta z publicznej do tylko serwera, zapewniając przyszłe żądania do strony ponowne wywołanie delegata, nie buforując go na kliencie.

Uwaga

Podstawianie po pamięci podręcznej nie jest obsługiwane w przypadku buforowanej kontrolki użytkownika, w której buforowanie wyjściowe jest stosowane na poziomie kontroli użytkownika. Jest to również nazywane buforowaniem fragmentów. Aby uzyskać więcej informacji, zobacz Buforowanie części strony ASP.NET.

Dotyczy

Zobacz też