HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> unitPublic Sub WriteSubstitution (callback As HttpResponseSubstitutionCallback)Parametri
- callback
- HttpResponseSubstitutionCallback
Metodo, controllo utente o oggetto da sostituire.
Eccezioni
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.
