Elemento caching (schema delle impostazioni ASP.NET)

  • Articolo

[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]

Configura le impostazioni della cache per un'applicazione Web.

<caching>
   <cache>...</cache>
   <outputCache>...</outputCache>
   <outputCacheSettings>...</outputCacheSettings>
   <sqlCacheDependency>...</sqlCacheDependency>
</caching>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Nessuno.

Elementi figlio

Elemento

Descrizione

Cache

Elemento facoltativo.

Definisce le impostazioni globali della cache dell'applicazione.

outputCache

Elemento facoltativo.

Specifica le impostazioni della cache di output a livello di applicazione.

outputCacheSettings

Elemento facoltativo.

Specifica le impostazioni della cache di output che è possibile applicare alle pagine in un'applicazione.

sqlCacheDependency

Elemento facoltativo.

Configura le dipendenze della cache di SQL per un'applicazione ASP.NET.

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.

Note

Configurazione predefinita

Il seguente elemento caching predefinito non viene configurato in modo esplicito nel file Machine.config o nel file Web.config a livello di radice, ma è la configurazione predefinita restituita da un'applicazione in .NET Framework versione 2.0.

<caching>
  <cache disableMemoryCollection = "false" 
    disableExpiration = "false" 
    privateBytesLimit = "0" 
    percentagePhysicalMemoryUsedLimit = "90" 
    privateBytesPollTime = "00:02:00"/>

  <outputCache enableOutputCache = "true" 
    enableFragmentCache = "true" 
    sendCacheControlHeader = "true" 
    omitVaryStar = "false" >
  </outputCache>

  <outputCacheSettings>
    <outputCacheProfiles>
      <clear />
      <add name = "" 
        enabled = "true" 
        duration = "-1" 
        location = "" 
        sqlDependency = "" 
        varyByCustom = "" 
        varyByControl = "" 
        varyByHeader = "" 
        varyByParam = "" 
        noStore = "false"/>
    </outputCacheProfiles>
  </outputCacheSettings>

  <sqlCacheDependency enabled = "true" 
    pollTime = "60000">
    <databases>
       <clear />
      <add name = "" 
        connectionStringName = "" 
        pollTime = "60000"/>
    </databases>
  </sqlCacheDependency>

</caching>

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.CacheSection

System.Web.Configuration.OutputCacheSection

System.Web.Configuration.OutputCacheSettingsSection

System.Web.Configuration.SqlCacheDependencySection

Membro di configurazione

System.Web.Configuration.SystemWebCachingSectionGroup

Percorsi configurabili

Machine.config

Web.config a livello di radice

Web.config a livello di applicazione

Requisiti

IIS 5.0, 5.1 e 6.0

.NET Framework 2.0

Visual Studio 2005

Vedere anche

Attività

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Riferimenti

Elemento system.web (schema delle impostazioni ASP.NET)

Elemento configuration (schema delle impostazioni generali)

Elemento cache per caching (schema delle impostazioni ASP.NET)

Elemento outputCache per caching (schema delle impostazioni ASP.NET)

Elemento outputCacheSettings per caching (schema delle impostazioni ASP.NET)

Elemento sqlCacheDependency per caching (schema delle impostazioni ASP.NET)

System.Configuration

System.Web.Configuration

Concetti

ASP.NET Caching Overview

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Altre risorse

Impostazioni di configurazione generali (ASP.NET)

Impostazioni di configurazione di ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API