Partilhar via

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

  • Artigo

Adiciona um OutputCacheProfile objeto à coleção de configuração. Perfis de cache somente podem ser acessados a partir de @ OutputCache diretiva para as páginas. Não há suporte para perfis em controles de usuário ou controles do servidor.

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)
          Adicionar elemento para outputCacheProfiles para armazenamento em cache (ASP.NET Settings esquema)

<add name="String" 
     enabled="true|false" 
     duration="number" 
     location="Any|Client|Downstream|Server|None|ServerAndClient" 
     sqlDependency="String" 
     varyByCustom="String" 
     varyByControl="String" 
     varyByHeader="String" 
     varyByParam="String" 
     noStore="true|false" />

Atributos e elementos

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

Atributos

Atributo

Descrição

name

Necessário String atributo.

Define o nome exclusivo do analisar de cache.

enabled

Opcional Boolean atributo.

Habilita cache para um analisar de saída.

duration

Opcional TimeSpan atributo.

Define a quantidade de time em segundos que uma página é armazenada no cache.

location

Opcional Int32 atributo.

Determina onde a resposta armazenada em cache podem ser armazenados.

sqlDependency

Opcional String atributo.

Define a nível de página a dependência de cache do SQL.

varyByCustom

Opcional String atributo.

Define a seqüência de caracteres que é usada ao chamar varyByCustom para a página.

varyByControl

Opcional String atributo.

Define a ID do controle seja armazenada em cache e usada ao chamar varyByControl. Também é possível conjunto uma lista delimitada por ponto-e-vírgula de identificações.

varyByHeader

Opcional String atributo.

Nomes por ponto-e-vírgula delimitada por conjunto de cabeçalhos usada para variar a saída em cache.

varyByParam

Opcional String atributo.

Nomes por ponto-e-vírgula delimitada por conjunto de parâmetros usada para variar a saída em cache.

noStore

Opcional Boolean atributo.

Define um valor indicando se o "Cache-controle: diretiva de armazenamento não"é enviada na resposta para as páginas em cache.

Elementos filho

Nenhum.

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 podem ser aplicadas a páginas em um aplicativo ASP.NET.

outputCacheProfiles

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

Comentários

Configuração padrão

O seguinte padrão add 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 por um aplicativo do .NET estrutura versão 2.0.

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

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 de 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

IIS versão 5.0, 5.1 e 6.0

.NET Framework versão 2,0

Visual Studio 2005

Consulte também

Tarefas

Demonstra Passo a passo: Usando o cache para melhorar o desempenho do site da Web de saída

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)

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