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 delle risposte nella risposta, che consente la generazione dinamica di aree di risposta specificate per le 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 callback parametro è di tipo Control.
Commenti
È possibile usare il WriteSubstitution metodo per la sostituzione post-cache nelle pagine memorizzate nella cache di output. Passando un HttpContext oggetto a un metodo di callback con una firma prestabilita, è possibile sostituire il contenuto memorizzato HttpResponseSubstitutionCallback nella cache di output in qualsiasi posizione nella cache delle pagine. 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 per le richieste future. Infine, degrada la cache lato client da pubblica a solo server, garantendo richieste future alla pagina richiamare nuovamente il delegato non memorizzando nella cache nel client.
Note
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 parti Caching di una pagina ASP.NET.
