XmlDataSource.EnableCaching Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta un valore indicante se la memorizzazione di dati nella cache è abilitata nel controllo XmlDataSource.

public:
 virtual property bool EnableCaching { bool get(); void set(bool value); };
public virtual bool EnableCaching { get; set; }
member this.EnableCaching : bool with get, set
Public Overridable Property EnableCaching As Boolean

Valore della proprietà

Boolean

true se la memorizzazione di dati nella cache è abilitata per il controllo origine dati; in caso contrario, false. Il valore predefinito è true.

Esempio

Nell'esempio di codice seguente viene illustrato come abilitare la memorizzazione nella cache quando si usa il XmlDataSource controllo per visualizzare i dati contenuti in un file XML. Caching è abilitato quando la EnableCaching proprietà è impostata su true e viene CacheDuration impostato sul numero di secondi in cui i dati vengono memorizzati nella cache dal controllo origine dati.

<%@ 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>

Il file XML nell'esempio di codice contiene i dati seguenti:

<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>

Commenti

Il XmlDataSource controllo memorizza automaticamente nella cache i dati quando la EnableCaching proprietà è impostata su true. Per impostazione predefinita, la CacheDuration proprietà è impostata su 0, che indica una cache indefinita e l'origine dati memorizza nella cache i dati fino a quando non viene modificato il file XML da cui dipende. Se si imposta la CacheDuration proprietà su un valore maggiore di 0, la cache archivia i dati per tale numero di secondi prima di recuperare un nuovo set.

Se la EnableCaching proprietà è impostata su e la TransformArgumentList proprietà è impostatatrue, le voci della cache non vengono invalidate automaticamente quando i parametri cambiano nell'elenco di argomenti transforms. In tal caso, è necessario scrivere codice per invalidare la cache impostando la CacheKeyDependency proprietà .

Si applica a

Vedi anche