Cache elemento (esquema configurações ASP.NET)

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

configuração elemento (Geral Settings esquema)
  System.Web elemento (esquema configurações ASP.NET) 
    Cache elemento (esquema configurações ASP.NET)

<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 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 podem ser aplicadas a páginas no aplicativo.
sqlCacheDependency	Elemento opcional. Configura as dependências de cache SQL para um aplicativo ASP.NET.

Elementos pai

Elemento	Descrição
configuration	O elemento raiz exigido em todos os arquivos de configuração usado por common linguagem tempo de execução e .NET estrutura aplicativos.
System.web	Especifica o elemento raiz para as definições de configuração do ASP.NET em um arquivo de configuração. Contém elementos de configuração configurar aplicativos ASP.NET e o controle como os aplicativos se comportam.

Comentários

Configuração padrão

O seguinte padrão caching elemento não está configurado explicitamente na computador. arquivo de configuração ou na raiz da Web. arquivo de configuração, mas é a configuração padrão retornada pelo aplicativo do .NET estrutura 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 versões diferentes 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>

Durante a criação de 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
Configuração de membro	System.Web.Configuration.SystemWebCachingSectionGroup
Locais configuráveis	Machine.config Web.config de nível de raiz Nível do 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 de local

Como: Bloquear ASP.NET Configuration Settings

Conceitos

Visão geral do cache no ASP.NET

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

Protegendo configuração ASP.NET

Cenários de configuração ASP.NET

Referência

System.Web elemento (esquema configurações ASP.NET) 

configuração elemento (Geral Settings esquema)

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

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

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

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

System.Configuration

System.Web.Configuration

Outros recursos

Configurações gerais (ASP.NET)

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

Administrando ites da Web do ASP.NET

Arquivos de configuração ASP.NET

API de Configuração do ASP.NET