HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Methode
Definition
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 -> unitPublic Sub WriteSubstitution (callback As HttpResponseSubstitutionCallback)Parameter
- callback
- HttpResponseSubstitutionCallback
Die Methode, das Benutzersteuerelement oder das Objekt, die bzw. das ersetzt werden soll.
Ausnahmen
Das Ziel des callback-Parameters ist vom Typ Control.
Hinweise
Sie können die -Methode für die WriteSubstitution Ersetzung nach dem Cache auf Ihren seiten verwenden, die zwischengespeichert wurden. Indem Sie ein HttpContext Objekt an eine Rückrufmethode mit einer vorgeschriebenen HttpResponseSubstitutionCallback Signatur übergeben, können Sie den zwischengespeicherten Ausgabeinhalt an einem beliebigen Speicherort im Seitencache ersetzen. Um die Ersetzung zu initiieren, rufen Sie die WriteSubstitution -Methode auf, und übergeben Sie ihr die Rückrufmethode, die threadsicher sein muss und eine der folgenden Sein kann:
- Eine statische Methode auf der Containerseite oder dem Benutzersteuerelement.
- Eine statische oder instance Methode für ein anderes beliebiges Objekt.
Bei der ersten Anforderung an die Seite ruft den WriteSubstitutionHttpResponseSubstitutionCallback Delegaten auf, um die Ausgabe zu erzeugen. Anschließend wird der Antwort ein Ersetzungspuffer hinzugefügt, der den Delegat bei zukünftigen Anforderungen beibehält. Schließlich wird die clientseitige Zwischenspeicherbarkeit von öffentlich auf nur serverseitig herabgesetzt, wodurch sichergestellt wird, dass zukünftige Anforderungen an die Seite den Delegaten erneut aufrufen, indem auf dem Client keine Zwischenspeicherung erfolgt.
Hinweis
Die Ersetzung nach dem Cache wird für ein zwischengespeichertes Benutzersteuerelement nicht unterstützt, bei dem die Ausgabezwischenspeicherung auf Benutzersteuerungsebene angewendet wird. Dies wird auch als Fragmentzwischenspeicherung bezeichnet. Weitere Informationen finden Sie unter Zwischenspeichern von Teilen einer ASP.NET Seite.
