HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Methode

Referenz

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ermöglicht das Einfügen von Antwortersetzungsblöcken in die Antwort, wodurch das dynamische Generieren von angegebenen Antwortbereichen für Antworten im Ausgabecache ermöglicht wird.

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)

Parameter

callback: HttpResponseSubstitutionCallback

Die Methode, das Benutzersteuerelement oder das Objekt, die bzw. das ersetzt werden soll.

Ausnahmen

ArgumentException

Das Ziel des callback-Parameters ist vom Typ Control.

Hinweise

Sie können die WriteSubstitution Methode zum Ersetzen von Zwischenspeichern in Ihren Ausgabecacheseiten verwenden. Indem Sie ein HttpContext Objekt an eine Rückrufmethode mit einer vorgeschriebenen HttpResponseSubstitutionCallback Signatur übergeben, können Sie die ausgabegespeicherten Inhalte an jedem bestimmten Speicherort im Seitencache ersetzen. Um den Ersatz zu initiieren, rufen Sie die WriteSubstitution Methode auf, indem Sie die Rückrufmethode übergeben, die threadsicher sein muss und eine der folgenden Sein kann:

Eine statische Methode auf der Containerseite oder dem Benutzersteuerelement.
Eine statische oder Instanzmethode für ein anderes beliebiges Objekt.

Auf der ersten Anforderung an die Seite ruft der WriteSubstitution Stellvertretung die HttpResponseSubstitutionCallback Ausgabe auf. Anschließend fügt er der Antwort einen Ersatzpuffer hinzu, der die Stellvertretung beibehalten, um zukünftige Anforderungen anzurufen. Schließlich wird die clientseitige Zwischenspeicherbarkeit von öffentlichen zu serverseitigen Anforderungen verringert, wodurch zukünftige Anforderungen an die Seite erneut aufgerufen werden, indem sie nicht im Client zwischenspeichern.

Hinweis

Die Zwischenspeicherung nach dem Cache wird für ein zwischengespeichertes Benutzersteuerelement nicht unterstützt, bei dem die Ausgabespeicherung auf Benutzersteuerungsebene angewendet wird. Dies wird auch als Fragmentspeicherung bezeichnet. Weitere Informationen finden Sie unter Zwischenspeichern von Teilen einer ASP.NET Seite.

Gilt für