XmlDataSource.CacheDuration プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

XmlDataSource.CacheDuration プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 CacheDuration As Integer

Visual Basic (使用法)

Dim instance As XmlDataSource
Dim value As Integer

value = instance.CacheDuration

instance.CacheDuration = value

public virtual int CacheDuration { get;
 set; }

C++

public:
virtual property int CacheDuration {
    int get ();
    void set (int value);
}

/** @property */
public int get_CacheDuration ()

/** @property */
public void set_CacheDuration (int
 value)

JScript

public function get CacheDuration
 () : int

public function set CacheDuration
 (value : int)

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

解説

XmlDataSource コントロールは、次の設定が適用されていると、データを自動的にキャッシュします。

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

Data プロパティまたは XML データが格納されているファイルの内容に変更を加えると、キャッシュが無効になります。

既定では、CacheDuration プロパティは 0 に設定され、キャッシュに対して無制限にデータが格納されます。この場合、データソースに関連付けられている XML ファイルが変更されるまで、データがキャッシュされ続けます。

キャッシュの動作は、存続時間と CacheExpirationPolicy 設定を組み合わせることによって制御されます。CacheExpirationPolicy を Absolute に設定した場合、XmlDataSource コントロールは、1 回目のデータ取得操作時にキャッシュしたデータを、CacheDuration に指定された期間、メモリ内に保持し、その期間が経過すると、キャッシュ内のデータを無効にします。キャッシュは次回操作時にリフレッシュされます。CacheExpirationPolicy を Sliding に設定した場合、データソースコントロールは、1 回目のデータ取得操作時にデータをキャッシュしますが、以降、操作のたびにキャッシュの存続期間がリセットされます。前回のデータ取得以降、CacheDuration に指定された時間が経過してもアクティビティがない場合、キャッシュの有効期限が切れます。

使用例

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

Visual Basic

<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML
 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>
    <form 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="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>

    <form 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="VJ#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>

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