Compartilhar via


Armazenando Múltiplas Versões de uma Página

Às vezes, você pode ter uma página para a qual você deseja criar cache, mas para quais versões diferentes são criadas com base na solicitação.Por exemplo, a página pode ter uma saída diferente dependendo dos valores passados em uma sequência de caracteres da consulta.

O ASP.NET permite que você armazene várias versões da mesma página no cache de saída.Você pode variar o cache de saída pelo seguinte:

  • O sequência de caracteres da consulta em uma solicitação inicial (HTTP GET).

  • Valores de controle passados no postback (valores HTTP POST).

  • Os cabeçalhos HTTP passados com uma solicitação.

  • O número de versão principal do navegador fazendo a consulta.

  • Uma sequência de caracteres personalizada na página.Nesse caso, você cria código personalizado no arquivo Global.asax para especificar o comportamento do cache da página.

Você pode armazenar em cache várias versões da saída de uma página declarativamente por meio de programação usando atributos da diretiva @ OutputCache e as propriedades e métodos da classe HttpCachePolicy.

A diretiva @ OutputCache inclui quatro atributos que permitem que você armazene várias versões de saída de página:

  • O atributo VaryByParam permite que você varie a saída do cache dependendo da sequência de caracteres da consulta.

  • O atributo VaryByControl permite que você varie a saída do cache dependendo um valor de controle.

  • O atributo VaryByHeader permite que você varie a saída do cache dependendo a solicitação do cabeçalho HTTP.

  • O atributo VaryByCustom permite que você varie saída do cache por tipo de navegador ou uma sequência de caracteres personalizada que você define.

    Observação:

    Você deve incluir o atributo VaryByParam ou o atributo VaryByControl em qualquer diretiva @ OutputCache.No entanto, se você não precisar variar a saída do cache pelo controle ou por parâmetros, você pode definir VaryByParam como None.

A classe HttpCachePolicy fornece duas propriedades e um método que permitem que você especifique a configuração do mesmo cache que você pode definir declarativamente por programação.As propriedades VaryByParams e VaryByHeaders permitem que você especifique os parâmetros da cadeia de caracteres da consulta e os nomes do cabeçalho, respectivamente, pelos quais você deseja variar a diretiva de cache.O método SetVaryByCustom permite que você defina cadeias de caracteres personalizadas pelas quais o cache de saída vai variar.

Consulte também

Tarefas

Como: conjunto the Cacheability of an ASP.NET página declarativamente

Como: conjunto por programação Cacheability da página

Como: Versões de cache de uma página usando o navegador pedir

Como: Versões de cache de uma página usando parâmetros

Como: Versões de cache de uma página usando cabeçalhos HTTP

Como: Cache Versions of a página Using Custom Strings

Conceitos

Cache de páginas ASP.NET

Definindo a Cacheabilidade de uma Página