HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> unitPublic Sub WriteSubstitution (callback As HttpResponseSubstitutionCallback)Parametry
- callback
- HttpResponseSubstitutionCallback
Metoda, kontrolka użytkownika lub obiekt do zastąpienia.
Wyjątki
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.
