HttpCachePolicy.AddValidationCallback Método

Referência

Definição

Namespace:: System.Web

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Registra um retorno de chamada de validação para a resposta atual.

public:
 void AddValidationCallback(System::Web::HttpCacheValidateHandler ^ handler, System::Object ^ data);

public void AddValidationCallback (System.Web.HttpCacheValidateHandler handler, object data);

member this.AddValidationCallback : System.Web.HttpCacheValidateHandler * obj -> unit

Public Sub AddValidationCallback (handler As HttpCacheValidateHandler, data As Object)

Parâmetros

handler: HttpCacheValidateHandler

O valor HttpCacheValidateHandler.

data: Object

Os dados arbitrários fornecidos pelo usuário passados de volta para o delegado AddValidationCallback(HttpCacheValidateHandler, Object).

Exceções

ArgumentNullException

O handler especificado é null.

Exemplos

O exemplo de código a seguir demonstra como adicionar um delegado para validar uma solicitação com base em valores de cadeia de caracteres de consulta.

<%@ Page Language="C#" %>
<%@ OutputCache VaryByParam="none" Duration="600" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script language="c#" runat="server">

   static string validationstate;
 
   public void Page_Load()
   {
      Response.Cache.AddValidationCallback(new HttpCacheValidateHandler(ValidateCache), null);
      stamp.InnerHtml = DateTime.Now.ToString("r");
   }

   public static void ValidateCache(HttpContext context, Object data, ref HttpValidationStatus status) 
   {
      if (context.Request.QueryString["Valid"] == "false") 
      {
         status = HttpValidationStatus.Invalid;
      } 
      else if (context.Request.QueryString["Valid"] == "ignore") 
      {
         status = HttpValidationStatus.IgnoreThisRequest;
      } 
      else 
      {
         status = HttpValidationStatus.Valid;
      }
   }

</script>

<%@ Page Language="VB" %>
<%@ OutputCache VaryByParam="none" Duration="600" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
   shared validationstate As String

   Public Sub Page_Load(sender As Object, e As EventArgs)
      Response.Cache.AddValidationCallback(new HttpCacheValidateHandler(AddressOf Me.ValidateCache), nothing)
      stamp.InnerHtml = DateTime.Now.ToString("r")
   End Sub

   Public Shared Sub ValidateCache(context As HttpContext, data As Object, ByRef status as HttpValidationStatus)
      If (context.Request.QueryString("Valid") = "false") Then
         status = HttpValidationStatus.Invalid
      Elseif (context.Request.QueryString("Valid") = "ignore") Then
         status = HttpValidationStatus.IgnoreThisRequest
      Else
         status = HttpValidationStatus.Valid
      End If
   End Sub

</script>

Comentários

O AddValidationCallback método fornece um mecanismo para verificar a resposta programaticamente no cache antes que a resposta seja retornada ao cliente pelo cache de saída.

Antes que a resposta seja atendida do cache do servidor Web, todos os manipuladores registrados são consultados para garantir a validade do recurso. Se algum manipulador definir um sinalizador indicando que a resposta armazenada em cache não é válida, a entrada será marcada como não válida e expulsa do cache. Nesse caso, bem como quando qualquer manipulador indica que a resposta armazenada em cache deve ser ignorada para essa solicitação, a solicitação é tratada como se fosse uma falha de cache.

AddValidationCallbacké introduzido no .NET Framework versão 3.5. Para saber mais, confira Versões e dependências.

Aplica-se a

Partilhar via