XmlDataSource.CacheExpirationPolicy プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
キャッシュの存続期間と組み合わされた、データ ソース コントロールが使用するキャッシュの動作を記述するキャッシュの有効期限のポリシーを取得または設定します。
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
プロパティ値
DataSourceCacheExpiry 値のいずれか 1 つ。 既定では、キャッシュの有効期限のポリシーが Absolute に設定されています。
例
次のコード例は、コントロールを使用して XML ファイルに含まれるデータを XmlDataSource 表示するときにキャッシュを有効にする方法を示しています。 キャッシュは、プロパティがEnableCaching設定true
CacheDurationされていて、データ ソース コントロールによってデータがキャッシュされる秒数に設定されている場合に有効になります。
<%@ 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>
コード例の XML ファイルには、次のデータがあります。
<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>
注釈
キャッシュの動作は、設定とCacheExpirationPolicy設定のCacheDuration組み合わせによって制御されます。 CacheExpirationPolicyにAbsolute設定されている場合、最初のXmlDataSourceデータ取得操作でデータがキャッシュされ、指定されたCacheDuration時間のメモリ内に保持され、時間が経過した後に無効になります。 その後、キャッシュは次の操作時に更新されます。 にCacheExpirationPolicySliding設定されている場合、データ ソース管理は最初のデータ取得操作でデータをキャッシュしますが、後続の操作ごとにキャッシュを保持する時間枠をリセットします。 キャッシュの有効期限は、最後のデータ取得以降と等しい時間の CacheDuration アクティビティがない場合にのみ有効です。