Sdílet prostřednictvím

XmlDataSource.EnableCaching Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví hodnotu určující, zda XmlDataSource má ovládací prvek povoleno ukládání dat do mezipaměti.

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

Hodnota vlastnosti

Boolean

truepokud je pro správu zdrojů dat povoleno ukládání dat do mezipaměti; v opačném případě . false Výchozí hodnota je true.

Příklady

Následující příklad kódu ukazuje, jak povolit ukládání do mezipaměti při použití XmlDataSource ovládacího prvku k zobrazení dat obsažených v souboru XML. Ukládání do mezipaměti je povoleno, EnableCaching pokud je vlastnost nastavena true a CacheDuration je nastavena na počet sekund, po které jsou data uložena do mezipaměti pomocí ovládacího prvku zdroje dat.

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

Soubor XML v příkladu kódu obsahuje následující data:

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

Poznámky

Ovládací XmlDataSource prvek automaticky ukládá data do mezipaměti, pokud EnableCaching je vlastnost nastavena na true. Ve výchozím nastavení CacheDuration je vlastnost nastavena na hodnotu 0, která označuje neomezenou mezipaměť a zdroj dat bude ukládat data do mezipaměti, dokud se nezmění soubor XML, na kterém závisí. Pokud vlastnost nastavíte CacheDuration na hodnotu větší než 0, mezipaměť ukládá data po dobu tolik sekund před načtením nové sady.

EnableCaching Pokud je vlastnost nastavena a TransformArgumentList vlastnost je nastavenatrue, položky mezipaměti nejsou automaticky zneplatněny při změně parametrů v seznamu argumentů transformace. V takovém případě musíte napsat kód, který zneplatní mezipaměť nastavením CacheKeyDependency vlastnosti.

Platí pro

Viz také