Como: Verificar a validade de uma página armazenada

  • Artigo

Quando uma página em cache é solicitada por um usuário, ASP.NET determina se a saída em cache é ainda válida com base na política de cache que você tenha definido na página.Se a saída é válida, a saída em cache é enviada para o cliente e a página não é reprocessada.Entretanto, o ASP.NET fornece a você a capacidade de executar código durante esta verificação de validação usando uma validação callback, de modo que você possa escrever lógica personalizada para verificar se a página é válida.A validação callback permite-lhe invalidar páginas armazenadas em cache fora do processo normal de uso de dependências de cache.

Para verificar a validade de uma página armazenada em cache programaticamente

  1. Defina um manipulador de eventos do tipo HttpCacheValidateHandler e inclua código que verifica a validade da resposta da página armazenada em cache.

    O manipulador de validação deve retornar um dos seguintes valores HttpValidationStatus:

    • Invalid   Indica que a página armazenada em cache é inválida, a página é removida do cache, e a solicitação é tratada como perda de cache.

    • IgnoreThisRequest   Faz com que a solicitação seja tratada sistema autônomo ignorado de cache. A página é processada novamente, mas a página armazenada em cache não é invalidada.

    • Valid  Indica que a página armazenada na cache é válida.

    O exemplo de código a seguir ilustra um manipulador de validação chamadoValidateCacheOutput que determina se a variável sequência de caracteres de consulta status contém os valores "invalidar" ou "ignorar";.Se o valor de status é "invalidar", o método retorna Invalid e a página é invalidada na cache.Se o valor de status é "ignorar", o método retorna IgnoreThisRequest e a página é deixada no cache, mas uma nova resposta é gerada para este pedido.

    public static void ValidateCacheOutput(HttpContext context, Object data,
        ref HttpValidationStatus status)
{
    if (context.Request.QueryString["Status"] != null)
    {
        string pageStatus = context.Request.QueryString["Status"];

        if (pageStatus == "invalid")
            status = HttpValidationStatus.Invalid;
        else if (pageStatus == "ignore")
            status = HttpValidationStatus.IgnoreThisRequest;
        else
            status = HttpValidationStatus.Valid;
    }
    else
        status = HttpValidationStatus.Valid;
}

    Public Shared Sub ValidatePage(ByVal context As HttpContext, _
        ByVal data As [Object], ByRef status As HttpValidationStatus)
    If Not (context.Request.QueryString("Status") Is Nothing) Then
        Dim pageStatus As String = context.Request.QueryString("Status")

        If pageStatus = "invalid" Then
            status = HttpValidationStatus.Invalid
        ElseIf pageStatus = "ignore" Then
            status = HttpValidationStatus.IgnoreThisRequest
        Else
            status = HttpValidationStatus.Valid
        End If
   Else
       status = HttpValidationStatus.Valid
   End If
End Sub

  2. De um dos eventos de ciclo de vida de página (tais como o eventos da página Load), chama o método AddValidationCallback, passando como o primeiro argumento o manipulador de eventos que você definiu na etapa 1.

    O exemplo de código a seguir define o método ValidateCacheOutput para ser o manipulador de validação.

    protected void Page_Load(object sender, EventArgs e)
{
    Response.Cache.AddValidationCallback(
        new HttpCacheValidateHandler(ValidateCacheOutput),
        null);
}

    Protected Sub Page_Load(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Me.Load

    Response.Cache.AddValidationCallback( _
        New HttpCacheValidateHandler(AddressOf ValidatePage), Nothing)
End Sub

Consulte também

Conceitos

Cache de páginas ASP.NET