XmlDataSource.EnableCaching プロパティ

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

XmlDataSource.EnableCaching プロパティ

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

XmlDataSource コントロールでデータ ャッシュが有効かどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 EnableCaching As Boolean

Visual Basic (使用法)

Dim instance As XmlDataSource
Dim value As Boolean

value = instance.EnableCaching

instance.EnableCaching = value

C#

public virtual bool EnableCaching { get;
 set; }

C++

public:
virtual property bool EnableCaching {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_EnableCaching ()

/** @property */
public void set_EnableCaching (boolean value)

JScript

public function get EnableCaching
 () : boolean

public function set EnableCaching
 (value : boolean)

プロパティ値
データ ソース コントロールでデータ キャッシュが有効な場合は true。それ以外の場合は false。既定値は true です。

解説

EnableCaching プロパティが true に設定されている場合、XmlDataSource コントロールによってデータが自動的にキャッシュされます。既定では、CacheDuration プロパティは 0 に設定され、キャッシュに対して無制限にデータが格納されます。この場合、データ ソースに関連付けられている XML ファイルが変更されるまで、データがキャッシュされ続けます。CacheDuration プロパティを、0 より大きい値に設定した場合、指定された秒数データがキャッシュされた後で、新しいデータが取得されます。

EnableCaching プロパティが true に設定され、かつ TransformArgumentList プロパティが設定されている場合、変換用の引数リストでパラメータを変更しても、キャッシュ エントリは自動的に無効化されません。この場合、CacheKeyDependency プロパティを設定することにより、キャッシュを無効するためのコードを記述する必要があります。

使用例

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>

C#

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

J#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
XmlDataSource クラス
XmlDataSource メンバ
System.Web.UI.WebControls 名前空間
XmlDataSource.CacheDuration プロパティ
XmlDataSource.CacheExpirationPolicy プロパティ