XmlDataSource.CacheExpirationPolicy Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia zasady wygasania pamięci podręcznej, które są łączone z czasem trwania pamięci podręcznej w celu opisania zachowania buforowania pamięci podręcznej używanej przez kontrolkę źródła danych.
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
Wartość właściwości
Jedna z DataSourceCacheExpiry wartości. Domyślne ustawienie zasad wygasania pamięci podręcznej to Absolute.
Przykłady
W poniższym przykładzie kodu pokazano, jak włączyć buforowanie podczas używania kontrolki XmlDataSource do wyświetlania danych zawartych w pliku XML. Buforowanie jest włączona, gdy EnableCaching właściwość jest ustawiona true
na i CacheDuration jest ustawiona na liczbę sekund buforowanych przez kontrolę źródła danych.
<%@ 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>
Plik XML w przykładzie kodu zawiera następujące dane:
<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>
Uwagi
Zachowanie pamięci podręcznej podlega kombinacji CacheDuration ustawień i CacheExpirationPolicy . Jeśli jest CacheExpirationPolicy ustawiona Absolutewartość , XmlDataSource dane są buforowane na pierwszej operacji pobierania danych, przechowuje je w pamięci przez czas określony przez CacheDuration, i unieważnia je po upływie czasu. Pamięć podręczna jest następnie odświeżona po następnej operacji. Jeśli jest CacheExpirationPolicy ustawiona Slidingwartość , kontrolka źródła danych buforuje dane w pierwszej operacji pobierania danych, ale resetuje przedział czasu, dla którego przechowuje pamięć podręczną dla każdej kolejnej operacji. Pamięć podręczna wygaśnie tylko wtedy, gdy nie ma aktywności równej czasowi CacheDuration od ostatniego pobierania danych.