Adicionar elemento para outputCacheProfiles para armazenar em cache (ASP.NET Configurações Schema)

Artigo
08/04/2011

Adiciona um OutputCacheProfile o objeto à coleção de configuração. Perfis de cache somente podem ser referenciados a partir de @ outputcache diretriz para páginas. Perfis não são suportados em controles de usuário ou controles de servidor.

<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	Obrigatório String atributo. Define o nome exclusivo do perfil de cache.
enabled	Opcional Boolean atributo. Habilita o cache para um perfil de saída.
duration	Opcional TimeSpan atributo. Define a quantidade de tempo em segundos que uma página é armazenada em cache.
location	Opcional Int32 atributo. Determina onde a resposta em cache podem ser armazenados.
sqlDependency	Opcional String atributo. Define a dependência de cache SQL de nível de página.
varyByCustom	Opcional String atributo. Define a seqüência de caracteres é usada ao chamar varyByCustom para a página.
varyByControl	Opcional String atributo. Define o ID do controle para ser armazenado em cache e usado ao chamar varyByControl. Também pode ser definido como uma lista delimitada de ponto e vírgula de IDs.
varyByHeader	Opcional String atributo. Nomes de um ponto e vírgula delimitada por conjunto de cabeçalhos usada para variar a saída em cache.
varyByParam	Opcional String atributo. Nomes de um 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-Control: no-store" diretiva é enviada em resposta para páginas em cache.

Elementos filho

Nenhum.

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.
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 Visual Basic.
outputCacheProfiles	Contém grupos de configurações de cache que podem ser aplicadas às páginas para especificar o OutputCache diretiva.

Comentários

Configuração padrão

O seguinte padrão add elemento não está explicitamente configurado no arquivo de configuração de máquina ou no arquivo Web. config raiz, mas é a configuração padrão é retornada por um aplicativo do.NET Framework 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 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.OutputCacheSettingsSection
Membro de configuração	OutputCacheSettingsSection.OutputCacheProfiles
Locais configuráveis	Machine.config Web. config de nível de raiz. Nível de 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

Compartilhar via

Adicionar elemento para outputCacheProfiles para armazenar em cache (ASP.NET Configurações Schema)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Tarefas

Referência

Conceitos

Outros recursos

Recursos adicionais