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 die dynamische Generierung von angegebenen Antwortbereichen für zwischengespeicherte Ausgabeantworten 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 zu ersetzende Objekt.
Ausnahmen
Das Ziel des callback Parameters ist vom Typ Control.
Hinweise
Sie können die Methode für die WriteSubstitution Ersetzung nach dem Cache in Ihren zwischengespeicherten Ausgabeseiten verwenden. Indem Sie ein HttpContext Objekt an eine Rückrufmethode mit einer vorgeschriebenen HttpResponseSubstitutionCallback Signatur übergeben, können Sie zwischengespeicherte Ausgabeinhalte an einem beliebigen Speicherort im Seitencache ersetzen. Rufen Sie zum Initiieren des Ersetzungs die WriteSubstitution Methode auf, und übergeben Sie sie an die Rückrufmethode, die threadsicher sein muss und eine der folgenden Sein kann:
- Eine statische Methode auf der Containerseite oder einem Benutzersteuerelement.
- Eine statische oder Instanzmethode für ein anderes beliebiges Objekt.
Bei der ersten Anforderung an die Seite ruft WriteSubstitution der HttpResponseSubstitutionCallback Delegat die Ausgabe auf. Anschließend wird der Antwort ein Ersetzungspuffer hinzugefügt, der die Stellvertretung bei zukünftigen Anforderungen anfordert. Schließlich beeinträchtigt sie die clientseitige Cachebarkeit von öffentlich auf Server und stellt sicher, dass zukünftige Anforderungen an die Seite den Delegat erneut aufrufen, indem er nicht auf dem Client zwischenspeichert.
Note
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 Caching portions of an ASP.NET Page.
