XmlDataSource.EnableCaching プロパティ

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

public virtual bool EnableCaching { get; set; }

member this.EnableCaching : bool with get, set

Public Overridable Property EnableCaching As Boolean

プロパティ値

true データ ソース コントロールに対してデータ キャッシュが有効になっている場合。それ以外の場合は false。 既定値は true です。

例

次のコード例では、 XmlDataSource コントロールを使用して XML ファイルに含まれるデータを表示するときにキャッシュを有効にする方法を示します。 キャッシュは、 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>

注釈

XmlDataSource プロパティが EnableCaching に設定されている場合、true コントロールは自動的にデータをキャッシュします。 既定では、 CacheDuration プロパティは 0 に設定されます。これは無期限のキャッシュを示し、データ ソースは依存する XML ファイルが変更されるまでデータをキャッシュします。 CacheDuration プロパティを 0 より大きい値に設定すると、キャッシュは、新しいセットを取得する前に、その数秒間のデータを格納します。

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

こちらもご覧ください

• CacheDuration
• CacheExpirationPolicy