cache Element (ASP.NET Settings Schema)

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

Define as configurações de cache para um aplicativo da Web.

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

Attributes and Elements

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Attributes

Nenhum.

Child Elements

Elemento	Descrição
Cache	Elemento opcional. Define as configurações de cache de aplicativo global.
outputCache	Elemento opcional. Especifica as configurações de cache de saída de todo o aplicativo.
outputCacheSettings	Elemento opcional. Especifica as configurações de cache de saída que podem ser aplicadas a páginas no aplicativo.
sqlCacheDependency	Elemento opcional. Configura as dependências de cache SQL para um aplicativo ASP.NET Visual Basic.

Parent Elements

Elemento	Descrição
configuration	O elemento raiz necessários em cada arquivo de configuração usado pelo common language runtime e.Aplicativos do NET Framework.
System.web	Especifica o elemento raiz para o ASP.Configurações de configuração de rede em um arquivo de configuração. Contém elementos de configuração que configuram aplicativos da Web ASP.NET e controla o comportamento das aplicações.

Remarks

Configuração padrão

O seguinte padrão caching elemento não está explicitamente configurado no arquivo Machine. config ou no arquivo Web. config raiz, mas é a configuração padrão é retornada pelo aplicativo na.NET Framework versão 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>

Exemplo

O exemplo a seguir armazena em cache uma página no servidor somente por um minuto e armazena a diferentes versões da página com base no tipo de navegador e versão principal.

<outputCacheSettings>
  <outputCacheProfiles>
    <add name="ServerOnly" 
      duration="60" 
      varyByCustom="browser" 
      location="Server" />
  </outputCacheProfiles>
</outputCacheSettings>

Ao criar uma página que precisa ser armazenado em cache dessa maneira, você precisará adicionar a seguinte diretiva para a página:

<%@ OutputCache CacheProfile="ServerOnly" %>

Para obter mais informações, consulte: @ OutputCache.

Element Information

Manipulador da seção de configuração	System.Web.Configuration.CacheSection System.Web.Configuration.OutputCacheSection System.Web.Configuration.OutputCacheSettingsSection System.Web.Configuration.SqlCacheDependencySection
Membro de configuração	System.Web.Configuration.SystemWebCachingSectionGroup
Locais configuráveis	Machine.config Web. config de nível de raiz. Nível de aplicativo Web. config
Requisitos	O IIS 5.0, 5.1 e 6.0 .NET Framework 2.0 Visual Studio 2005

Consulte também

Tasks

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Reference

System. Web Element (ASP.NET Settings Schema)

configuração Element (General Settings Schema)

Elemento de cache para armazenamento em cache (ASP.NET Settings Schema)

outputCache elemento para o armazenamento em cache (ASP.NET Settings Schema)

outputCacheSettings elemento para o armazenamento em cache (ASP.NET Settings Schema)

sqlCacheDependency elemento para o armazenamento em cache (ASP.NET Settings Schema)

System.Configuration

System.Web.Configuration

Concepts

ASP.NET Caching Overview

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Other Resources

Configurações gerais (ASP.NET)

ASP.Definições de configuração de rede

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API