Elemento add per outputCacheProfiles per caching (schema delle impostazioni ASP.NET)

Articolo
08/11/2011

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	System.Web.Configuration.OutputCacheSettingsSection
Membro di configurazione	OutputCacheSettingsSection.OutputCacheProfiles
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

Condividi tramite

Elemento add per outputCacheProfiles per caching (schema delle impostazioni ASP.NET)

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Configurazione predefinita

Esempio

Informazioni sull'elemento

Vedere anche

Attività

Riferimenti

Concetti

Altre risorse

Risorse aggiuntive