XmlDataSource.CacheExpirationPolicy Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

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.

Obtient ou définit la stratégie d'expiration du cache combinée à la durée de mise en cache, pour décrire le comportement de mise en cache du cache que le contrôle de source de données utilise.

public:
 virtual property System::Web::UI::DataSourceCacheExpiry CacheExpirationPolicy { System::Web::UI::DataSourceCacheExpiry get(); void set(System::Web::UI::DataSourceCacheExpiry value); };

public virtual System.Web.UI.DataSourceCacheExpiry CacheExpirationPolicy { get; set; }

member this.CacheExpirationPolicy : System.Web.UI.DataSourceCacheExpiry with get, set

Public Overridable Property CacheExpirationPolicy As DataSourceCacheExpiry

Valeur de propriété

DataSourceCacheExpiry

Une des valeurs de l'objet DataSourceCacheExpiry. Le paramètre de stratégie d'expiration du cache par défaut est Absolute.

Exemples

L’exemple de code suivant montre comment activer la mise en cache lors de l’utilisation du XmlDataSource contrôle pour afficher les données contenues dans un fichier XML. La mise en cache est activée lorsque la EnableCaching propriété est définie true et que celle-ci CacheDuration est définie sur le nombre de secondes auxquelles les données sont mises en cache par le contrôle de source de données.

<%@ Page Language="C#" %>
<!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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>

    <form id="form1" runat="server">
      <asp:xmldatasource
        id="XmlDataSource1"
        runat="server"
        datafile="books.xml"
        enablecaching="True"
        cacheduration="60"
        cacheexpirationpolicy="Sliding" />

      <!- TreeView uses hierachical data, so the
          XmlDataSource uses an XmlHierarchicalDataSourceView
          when a TreeView is bound to it. -->

      <asp:treeview
        id="TreeView1"
        runat="server"
        datasourceid="XmlDataSource1">
        <databindings>
          <asp:treenodebinding datamember="book" textfield="title"/>
        </databindings>
      </asp:treeview>

    </form>
  </body>
</html>

<%@ Page Language="VB" %>
<!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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:xmldatasource
        id="XmlDataSource1"
        runat="server"
        datafile="books.xml"
        enablecaching="True"
        cacheduration="60"
        cacheexpirationPolicy="Sliding" />

      <!- TreeView uses hierachical data, so the
          XmlDataSource uses an XmlHierarchicalDataSourceView
          when a TreeView is bound to it. -->

      <asp:treeview
        id="TreeView1"
        runat="server"
        datasourceid="XmlDataSource1">
        <databindings>
          <asp:treenodebinding datamember="book" textfield="title"/>
        </databindings>
      </asp:treeview>

    </form>
  </body>
</html>

Le fichier XML de l’exemple de code contient les données suivantes :

<books>  
   <computerbooks>  
     <book title="Secrets of Silicon Valley" author="Sheryl Hunter"/>  
     <book title="Straight Talk About Computers" author="Dean Straight"/>  
     <book title="You Can Combat Computer Stress!" author="Marjorie Green"/>                  
   </computerbooks>  
   <cookbooks>  
     <book title="Silicon Valley Gastronomic Treats" author="Innes del Castill"/>  
   </cookbooks>  
</books>

Remarques

Le comportement du cache est régi par une combinaison des paramètres et CacheExpirationPolicy des CacheDuration paramètres. Si le CacheExpirationPolicy paramètre est défini Absolutesur , les XmlDataSource données sont mises en cache sur la première opération de récupération des données, la conserve en mémoire pendant la durée spécifiée par CacheDuration, et l’invalide après l’expiration du temps. Le cache est ensuite actualisé lors de l’opération suivante. Si la CacheExpirationPolicy valeur est définie Sliding, le contrôle de source de données met en cache les données sur la première opération de récupération des données, mais réinitialise la fenêtre de temps qu’il contient le cache pour chaque opération suivante. Le cache expire uniquement s’il n’y a aucune activité pendant une durée égale à celle CacheDuration de la dernière récupération de données.

S’applique à

Partager via