XmlDataSource.CacheDuration プロパティ

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

データ ソース コントロールが取得したデータをキャッシュする時間 (秒単位) を取得または設定します。

public:
 virtual property int CacheDuration { int get(); void set(int value); };
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.DataSourceCacheDurationConverter))]
public virtual int CacheDuration { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.DataSourceCacheDurationConverter))>]
member this.CacheDuration : int with get, set
Public Overridable Property CacheDuration As Integer

プロパティ値

Int32

XmlDataSource がデータ取得操作の結果をキャッシュする秒数。 既定値は 0 です。

属性
TypeConverterAttribute

例

次のコード例では、 コントロールを使用して XML ファイルに含まれるデータを XmlDataSource 表示するときにキャッシュを有効にする方法を示します。 プロパティが にtrue設定されCacheDuration、 がデータ ソース コントロールによってキャッシュされる秒数に設定されている場合EnableCaching、キャッシュが有効になります。

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

注釈

コントロールは XmlDataSource 、次の場合にデータを自動的にキャッシュします。

  • EnableCaching プロパティが true に設定されています。

  • プロパティは CacheDuration 0 より大きい値に設定されます。これは、キャッシュが無効になるまでにキャッシュがデータを格納する秒数を示します。

プロパティまたは XML データを Data 含むファイルの内容を変更すると、キャッシュが無効になります。

既定では、 CacheDuration プロパティは 0 に設定されています。これは不定キャッシュを示し、データ ソースは依存する XML ファイルが変更されるまでデータをキャッシュします。

キャッシュの動作は、期間と CacheExpirationPolicy 設定の組み合わせによって制御されます。 が にAbsolute設定されている場合CacheExpirationPolicy、コントロールはXmlDataSource最初のデータ取得操作でデータをキャッシュし、 でCacheDuration指定された時間だけメモリに保持し、時間が経過した後にそれを無効にします。 その後、キャッシュは次の操作時に更新されます。 が にSliding設定されている場合CacheExpirationPolicy、データ ソース管理は最初のデータ取得操作でデータをキャッシュしますが、後続の操作ごとにキャッシュを保持する時間枠をリセットします。 キャッシュは、最後のデータ取得以降に と等しい CacheDuration 時間のアクティビティがない場合にのみ期限切れになります。

適用対象

こちらもご覧ください