XmlDataSource.EnableCaching Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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
true veri kaynağı denetimi için veri önbelleğe alma etkinleştirildiyse; aksi takdirde , false. Varsayılan değer true değeridir.
Örnekler
Aşağıdaki kod örneği, xml dosyasındaki verileri görüntülemek için denetimi kullanırken XmlDataSource önbelleğe almayı etkinleştirmeyi gösterir. Özelliği olarak ayarlandığında true ve CacheDuration veri kaynağı denetimi tarafından verilerin önbelleğe alındığı saniye sayısına ayarlandığında önbelleğe alma 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 özelliği CacheDuration 0 olarak ayarlanır ve bu, süresiz bir önbelleği gösterir ve veri kaynağı, bağlı olduğu XML dosyası değiştirilene kadar 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 saniye boyunca veri 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.