HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web
Assembly:
System.Web.dll

Consente l'inserimento di blocchi di sostituzione della risposta nella risposta, che consente la generazione dinamica di aree di risposta specificate per risposte memorizzate nella cache di output.

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)

Parametri

callback
HttpResponseSubstitutionCallback

Metodo, controllo utente o oggetto da sostituire.

Eccezioni

ArgumentException

La destinazione del parametro callback è di tipo Control.

Commenti

È possibile usare il metodo per la WriteSubstitution sostituzione post-cache nelle pagine memorizzate nella cache di output. Passando un HttpContext oggetto a un metodo di callback con una firma prestabilita HttpResponseSubstitutionCallback , è possibile sostituire il contenuto memorizzato nella cache di output in qualsiasi posizione specificata nella cache della pagina. Per avviare la sostituzione, chiamare il WriteSubstitution metodo , passandolo al metodo di callback, che deve essere thread-safe e può essere uno dei seguenti:

  • Metodo statico nella pagina del contenitore o nel controllo utente.
  • Metodo statico o di istanza su un altro oggetto arbitrario.

Nella prima richiesta alla pagina chiama WriteSubstitution il HttpResponseSubstitutionCallback delegato per produrre l'output. Aggiunge quindi un buffer di sostituzione alla risposta, che mantiene il delegato da chiamare su richieste future. Infine, degrada la cache lato client da pubblica a solo server, assicurando che le richieste future alla pagina richiamino nuovamente il delegato non memorizzando nella cache nel client.

Nota

La sostituzione post-cache non è supportata per un controllo utente memorizzato nella cache in cui la memorizzazione nella cache dell'output viene applicata a livello di controllo utente. Questa operazione è nota anche come memorizzazione nella cache dei frammenti. Per altre informazioni, vedere Memorizzazione nella cache di parti di una pagina ASP.NET.

Si applica a

Vedi anche