caching Element (ASP.NET Settings Schema)

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

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

Atributos e elementos

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

Atributos

Nenhum.

Elementos filho

Elemento	Descrição
Cache	Elemento opcional. Define as configurações de cache global do aplicativo.
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 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.

Elementos pai

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.Definiçõ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.

Comentários

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 as diferentes versões da página com base no tipo de navegador e a 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.

Informações do elemento

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

Tarefas

Como: Configurar Diretórios Específicos Usando Configurações por Localização

Como: Bloquear definições de configuração ASP.NET

Referência

system.web Element (ASP.NET Settings Schema)

configuração Element (Geral Configurações Schema)

Elemento de cache para armazenamento em cache (ASP.NET Configurações Schema)

Elemento de outputCache para armazenamento em cache (ASP.NET Configurações Schema)

outputCacheSettings elemento para armazenamento em cache (ASP.NET Configurações Schema)

Elemento de sqlCacheDependency para cache (ASP.NET Configurações Schema)

System.Configuration

System.Web.Configuration

Conceitos

Visão geral do cache no ASP.NET

Hierarquia e Herança do Arquivo de Configuração do ASP.NET

Protegendo a configuração do ASP.NET

Cenários de configuração ASP.NET

Outros recursos

General Configuration Settings (ASP.NET)

ASP.NET Configuration Settings

Administração de Sites do ASP.NET

Arquivos de configuração ASP.NET

API de Configuração do ASP.NET