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

Especifica as configurações de cache de saída de todo o aplicativo.

<outputCache enableOutputCache="true|false" 
             enableFragmentCache="true|false" 
             sendCacheControlHeader="true|false" 
             omitVaryStar="true|false"
             defaultProvider="AspNetInternalProvider">
</outputCache>

Atributos e elementos

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

Atributos

Atributo

Descrição

enableOutputCache

Opcional Boolean atributo.

Ativa/desativa o cache de saída de página.

Se desabilitado, não há páginas são armazenados em cache independentemente das configurações declarativas ou por programação.

Valor padrão é true.

enableFragmentCache

Opcional Boolean atributo.

Ativa/desativa o cache de fragmento do aplicativo.

Se desabilitado, não há páginas são armazenados em cache independentemente do @ outputcache diretiva ou o cache do perfil usado. Inclui um cabeçalho cache-control indicando que os servidores proxy upstream bem como os clientes de navegador não devem tentar armazenar a saída de página.

Valor padrão é false.

sendCacheControlHeader

Opcional Boolean atributo.

Obtém ou define um valor indicando se o cache-control:private cabeçalho é enviado pelo módulo de cache de saída por padrão.

Valor padrão é false.

omitVaryStar

Opcional Boolean atributo.

Ativa/desativa o envio de um HTTP "Vary: *" cabeçalho de resposta. Com a configuração padrão de false, um "Vary: *" cabeçalho é enviado para páginas de saída em cache.

Valor padrão é false.

defaultProvider

Atributo de seqüência opcional.

Obtém ou define o provedor de cache de saída padrão.

Valor padrão é "aspnetinternalprovider". Este é o cache de memória fornecido pelo ASP.NET.

Elementos filho

Elemento

Descrição

providers

Um elemento filho opcional que pode ser usado para configurar provedores personalizados de cache de saída.

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.

Comentários

Configuração padrão

O seguinte padrão outputCache 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 pelo aplicativo na.NET Framework versão 2.0.

<outputCache enableOutputCache = "true" 
             enableFragmentCache = "true" 
             sendCacheControlHeader = "true" 
             omitVaryStar = "false"
             defaultProvider="AspNetInternalProvider">
</outputCache>

O exemplo a seguir mostra como desativar o cache de saída para um aplicativo ASP.NET aplicativo:

<outputCache enableOutputCache="false" />

Cache de saída extensível

ASP.NET permite estender o cache de saída e para configurar um ou mais provedores de cache de saída personalizados. Os provedores de cache de saída podem usar qualquer mecanismo de armazenamento para manter o conteúdo HTML. Essas opções de armazenamento pode incluir discos locais ou remotos, armazenamento, em nuvem e distribuído os mecanismos de cache.

Extensibilidade do provedor de cache de saída permite mais agressiva de design e estratégias de cache de saída mais inteligentes para sites da Web. Por exemplo, você pode criar um provedor de cache de saída que armazena em cache o "Top 10" páginas de um site na memória, ao mesmo tempo em que o cache de páginas que terão menos tráfego no disco. Como alternativa, você pode cache cada combinação de variar por para uma página processada, mas usar um cache distribuído para que o consumo de memória é descarregado a partir de servidores front-end da Web.

Criar um provedor personalizado de cache de saída como uma classe que deriva do OutputCacheProvider tipo. Você pode configurar o provedor no arquivo Web. config usando o providers da subseção da outputCache elemento.

Por padrão, no ASP.NET, todas as respostas HTTP, processado páginas e controles usam o cache de saída de na memória que está no exemplo anterior (onde o defaultProvider atributo está definido como AspNetInternalProvider). Você pode alterar o provedor de cache de saída padrão usado para um aplicativo Web, especificando um nome de provedor diferente para defaultProvider.

Além disso, você pode selecionar diferentes provedores de cache de saída para o controle individual e solicitações individuais. A maneira mais fácil para especificar um provedor diferente do cache de saída para controles de usuário da Web diferentes é fazer então declarativamente usando a providerName de atributo em uma diretiva de página ou controle, conforme mostrado no exemplo a seguir:

<%@ OutputCache Duration="60" VaryByParam="None" 
    providerName="DiskCache" %>

Você pode especificar um provedor de cache de saída diferente para uma solicitação HTTP e substituir o GetOutputCacheProviderName método no arquivo global. asax programaticamente especificar qual provedor para uma solicitação específica.

Consulte também

Tarefas

Passo a passo: usando cache de saída para melhorar o desempenho de site da Web

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

Referência

OutputCache

Conceitos

Visão geral do cache no ASP.NET

Protegendo a configuração do ASP.NET

Cenários de configuração ASP.NET

Outros recursos

Administração de Sites do ASP.NET