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

  • Articolo

Contiene gruppi di impostazioni della cache che è possibile applicare alle pagine per specificare la direttiva @OutputCache.

<outputCacheProfiles>
    <add.../>
    <clear />
    <remove.../>
</outputCacheProfiles>

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Nessuno.

Elementi figlio

Elemento

Descrizione

add

Elemento facoltativo.

Aggiunge un oggetto OutputCacheProfile all'insieme delle configurazioni.

clear

Elemento facoltativo.

Rimuove tutti gli oggetti OutputCacheProfile dall'insieme delle configurazioni.

remove

Elemento facoltativo.

Rimuove l'oggetto OutputCacheProfile con il nome specificato dall'insieme delle configurazioni.

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 e ai controlli in un'applicazione ASP.NET.

Note

Configurazione predefinita

Il seguente elemento outputCacheProfiles 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.

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

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 5.0, 5.1 e 6.0

.NET Framework 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 add per outputCacheProfiles per caching (schema delle impostazioni ASP.NET)

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

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

System.Configuration

System.Web.Configuration

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

File di configurazione ASP.NET

API di configurazione di ASP.NET