HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Methode

  • Referenz

Definition

Namespace:
System.Web
Assembly:
System.Web.dll

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 -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.

Gilt für:

Weitere Informationen