HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Metoda
Definicja
Ważny
Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.
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.
