Partilhar via


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

Contém grupos de configurações de cache que podem ser aplicados a páginas para especificar a diretiva @ OutputCache.

configuração elemento (Geral Settings esquema)
  System.Web elemento (esquema configurações ASP.NET) 
    Cache elemento (esquema configurações ASP.NET)
      outputCacheSettings elemento para o armazenamento em cache (ASP.NET Settings esquema)
        outputCacheProfiles elemento para outputCacheSettings para armazenamento em cache (ASP.NET Settings esquema)

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

Atributos e elementos

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

Atributos

Nenhum.

Elementos filho

Elemento

Descrição

add

Elemento opcional.

Adiciona um OutputCacheProfile objeto à coleção de configuração.

clear

Elemento opcional.

Remove todos os OutputCacheProfile objetos da coleção de configuração.

remove

Elemento opcional.

Remove o OutputCacheProfile objeto com o nome especificado da coleção de configuração.

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.

caching

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

outputCacheSettings

Especifica as configurações de cache de saída que podem ser aplicadas a páginas e controles em um aplicativo ASP.NET.

Comentários

Configuração padrão

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

Exemplo

O exemplo a seguir armazena em cache uma página no servidor por apenas 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.OutputCacheSettingsSection

Configuração de membro

OutputCacheSettingsSection.OutputCacheProfiles

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)

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

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

Adicionar elemento para outputCacheProfiles para armazenamento em cache (ASP.NET Settings esquema)

desmarcar o elemento de outputCacheProfiles para armazenamento em cache (ASP.NET Settings esquema)

Remover elemento para outputCacheProfiles para 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