HttpCachePolicy.SetValidUntilExpires(Boolean) Méthode

Référence

Définition

Espace de noms:: System.Web

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Spécifie si le cache ASP.NET doit ignorer les en-têtes HTTP Cache-Control envoyés par le client qui invalident le cache.

public:
 void SetValidUntilExpires(bool validUntilExpires);

public void SetValidUntilExpires (bool validUntilExpires);

member this.SetValidUntilExpires : bool -> unit

Public Sub SetValidUntilExpires (validUntilExpires As Boolean)

Paramètres

validUntilExpires: Boolean

true si le cache ignore les en-têtes d'invalidation Cache-Control ; sinon, false.

Exemples

L’exemple de code suivant montre comment utiliser la SetValidUntilExpires méthode pour indiquer que les en-têtes d’invalidation du cache envoyés par le client sont ignorés.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
<script language="C#" runat="server">

// The following example demonstrates the SetValidUntilExpires method of the
// HttpCachePolicy class. The SetValidUntilExpires method is set to true so 
// that the ASP.NET cache ignores the HTTP Cache-Control headers and the page 
// remains in the cache until it expires.

void Page_Load(object Sender, EventArgs e)
{
   // Set the expiration time for the page.
   Response.Cache.SetExpires(DateTime.Now.AddSeconds(60));
   // Set the VaryByHeaders attribute with the value Accept-Language to true.
   Response.Cache.VaryByHeaders["Accept-Language"] = true;
   // ASP.NET ignores cache invalidation headers and the page remains in 
   // the cache until it expires.
   Response.Cache.SetValidUntilExpires(true);
   Response.Write("The SetValidUntilExpires method is set to true and ASP.NET cache should " + 
      "ignore the Cache-Control headers sent by the client that invalidate the cache.");
}

</script>
</head>
<body></body>
</html>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
<script language="VB" runat="server">

' The following example demonstrates the SetValidUntilExpires method of the
' HttpCachePolicy class. The SetValidUntilExpires method is set to true so that
' the ASP.NET cache ignores the HTTP Cache-Control headers and the page remains 
' in the cache until it expires.

Sub Page_Load(Sender As Object, e As EventArgs)
   ' Set the expiration time for the page.
   Response.Cache.SetExpires(DateTime.Now.AddSeconds(60))
   ' Set the VaryByHeaders attribute with the value Accept-Language to true.
   Response.Cache.VaryByHeaders("Accept-Language") = True
   ' ASP.NET ignores cache invalidation headers and the page remains in
   ' the cache until it expires.
   Response.Cache.SetValidUntilExpires(True)
   Response.Write("The SetValidUntilExpires method is set to true and the ASP.NET cache will " _
      & " ignore the Cache-Control headers sent by the client that invalidate the cache.")
End Sub 'Page_Load

</script>
</head>
<body></body>
</html>

Remarques

La SetValidUntilExpires méthode est définie true automatiquement lorsque la directive de page de haut niveau <%@ OutputCache … %> est utilisée.

Cette méthode est fournie car certains navigateurs, lors de l’actualisation d’un affichage de page, envoient des en-têtes d’invalidation du cache HTTP au serveur Web et suppriment la page du cache. Lorsque le validUntilExpires paramètre est true, ASP.NET ignore les en-têtes d’invalidation du cache et la page reste dans le cache jusqu’à son expiration.

SetValidUntilExpiresest introduit dans la .NET Framework version 3.5. Pour plus d’informations, consultez Versions et dépendances.

S’applique à