Elemento add per outputCacheProfiles per caching (schema delle impostazioni ASP.NET)
Aggiunge un oggetto OutputCacheProfile all'insieme delle configurazioni. Ai profili della cache è possibile fare riferimento solo dalla direttiva @ OutputCache per le pagine. I profili non sono supportati sui controlli utente o sui controlli server.
<add name="String"
enabled="true|false"
duration="number"
location="Any|Client|Downstream|Server|None|ServerAndClient"
sqlDependency="String"
varyByCustom="String"
varyByControl="String"
varyByHeader="String"
varyByParam="String"
noStore="true|false" />
Attributi ed elementi
Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.
Attributi
Attributo |
Descrizione |
---|---|
name |
Attributo String obbligatorio. Imposta il nome univoco del profilo della cache. |
enabled |
Attributo Boolean facoltativo. Attiva la cache di output per un profilo. |
duration |
Attributo TimeSpan facoltativo. Imposta il periodo di tempo, espresso in secondi, di memorizzazione di una pagina nella cache. |
location |
Attributo Int32 facoltativo. Determina la posizione in cui è consentita la memorizzazione della risposta inserita nella cache. |
sqlDependency |
Attributo String facoltativo. Imposta la dipendenza della cache SQL a livello di pagina. |
varyByCustom |
Attributo String facoltativo. Imposta la stringa utilizzata quando si chiama varyByCustom per la pagina. |
varyByControl |
Attributo String facoltativo. Imposta l'ID del controllo da memorizzare nella cache e utilizzare quando si chiama varyByControl. Può inoltre essere impostato su un elenco di ID delimitato da punti e virgola. |
varyByHeader |
Attributo String facoltativo. Specifica un set delimitato da punti e virgola di intestazioni utilizzate per variare l'output memorizzato nella cache. |
varyByParam |
Attributo String facoltativo. Specifica un set delimitato da punti e virgola di parametri utilizzati per variare l'output memorizzato nella cache. |
noStore |
Attributo Boolean facoltativo. Imposta un valore che indica se la direttiva "Cache-Control: no-store" viene inviata nella risposta per le pagine memorizzate nella cache. |
Elementi figlio
Nessuno.
Elementi padre
Elemento |
Descrizione |
---|---|
configuration |
È l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework. |
system.web |
Specifica l'elemento di primo livello per le impostazioni di configurazione ASP.NET in un file di configurazione. Contiene gli elementi per la configurazione di applicazioni Web ASP.NET e il controllo del comportamento delle stesse. |
caching |
Configura le impostazioni della cache per un'applicazione Web. |
outputCacheSettings |
Specifica le impostazioni della cache di output che è possibile applicare alle pagine in un'applicazione ASP.NET. |
outputCacheProfiles |
Contiene gruppi di impostazioni della cache che è possibile applicare alle pagine per specificare la direttiva OutputCache. |
Note
Configurazione predefinita
Il seguente elemento add predefinito non viene configurato in modo esplicito nel file di configurazione del computer o nel file Web.config a livello di radice, ma è la configurazione predefinita restituita da un'applicazione in .NET Framework versione 2.0.
<add name = ""
enabled = "true"
duration = "-1"
location = ""
sqlDependency = ""
varyByCustom = ""
varyByControl = ""
varyByHeader = ""
varyByParam = ""
noStore = "false"/>
Esempio
Nell'esempio riportato di seguito una pagina viene memorizzata nella cache sul server solo per un minuto e in versioni differenti in base al tipo di browser e alla versione principale..
<outputCacheSettings>
<outputCacheProfiles>
<add name="ServerOnly"
duration="60"
varyByCustom="browser"
location="Server" />
</outputCacheProfiles>
</outputCacheSettings>
Quando si progetta una pagina che deve essere memorizzata nella cache in questo modo, è necessario aggiungere la seguente direttiva:
<%@ OutputCache CacheProfile="ServerOnly" %>
Per ulteriori informazioni, vedere @ OutputCache.
Informazioni sull'elemento
Gestore della sezione di configurazione |
|
Membro di configurazione |
|
Percorsi configurabili |
Machine.config Web.config a livello di radice Web.config a livello di applicazione |
Requisiti |
IIS versione 5.0, 5.1 e 6.0 .NET Framework versione 2.0 Visual Studio 2005 |
Vedere anche
Attività
Procedura: configurare directory specifiche utilizzando impostazioni di percorso
Procedura: bloccare le impostazioni di configurazione di ASP.NET
Riferimenti
Elemento system.web (schema delle impostazioni ASP.NET)
Elemento configuration (schema delle impostazioni generali)
Elemento caching (schema delle impostazioni ASP.NET)
Elemento outputCacheSettings per caching (schema delle impostazioni ASP.NET)
Elemento outputCacheProfiles per outputCacheSettings per caching (schema delle impostazioni ASP.NET)
Concetti
Cenni preliminari sull'inserimento nella cache in ASP.NET
Gerarchia ed ereditarietà dei file di configurazione di ASP.NET
Protezione della configurazione di ASP.NET
Scenari di configurazione ASP.NET
Altre risorse
Impostazioni di configurazione generali (ASP.NET)
Impostazioni di configurazione di ASP.NET
Amministrazione di siti Web ASP.NET