XmlDataSource.EnableCaching Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Denetimin veri önbelleğe alma özelliğinin XmlDataSource etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.

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

Özellik Değeri

Boolean

true veri kaynağı denetimi için veri önbelleğe alma etkinleştirildiyse; aksi takdirde , false. true varsayılan değerdir.

Örnekler

Aşağıdaki kod örneği, bir XML dosyasındaki verileri görüntülemek için denetimi kullanırken önbelleğe almayı etkinleştirmeyi XmlDataSource gösterir. Önbelleğe Alma özelliği olarak ayarlandığında true ve CacheDuration değeri veri kaynağı denetimi tarafından verilerin önbelleğe alınma saniye sayısına ayarlandığında etkinleştirilirEnableCaching.

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

Kod örneğindeki XML dosyasında aşağıdaki veriler vardır:

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

Açıklamalar

XmlDataSource özelliği olarak ayarlandığında denetim verileri EnableCaching otomatik olarak önbelleğe truealır. Varsayılan olarak, CacheDuration özelliği belirsiz bir önbelleği gösteren 0 olarak ayarlanır ve bağlı olduğu XML dosyası değiştirilene kadar veri kaynağı verileri önbelleğe alır. özelliğini 0'dan büyük bir değere ayarlarsanız CacheDuration önbellek, yeni bir kümeyi almadan önce bu kadar saniyelik verileri depolar.

EnableCaching özelliği olarak ayarlanırsa true ve TransformArgumentList özellik ayarlanırsa, dönüştürme bağımsız değişken listesinde parametreler değiştiğinde önbellek girdileri otomatik olarak geçersiz kılınmaz. Bu durumda, özelliğini ayarlayarak CacheKeyDependency önbelleği geçersiz kılmaya ilişkin kod yazmanız gerekir.

Şunlara uygulanır

Ayrıca bkz.