XmlDataSource.CacheDuration 属性

定义

获取或设置数据源控件检索到的数据的缓存时间长度(以秒为单位)。

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

属性值

XmlDataSource 控件缓存数据检索操作结果的秒数。 默认值为 0。

属性

示例

下面的代码示例演示如何在使用 XmlDataSource 控件显示 XML 文件中包含的数据时启用缓存。 当 属性设置为 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 的值,该值指示缓存在缓存失效之前存储数据的秒数。

Data 包含 XML 数据的文件的属性或内容的任何更改都会导致缓存失效。

默认情况下, CacheDuration 属性设置为 0,这表示无限期缓存,数据源将缓存数据,直到更改它所依赖的 XML 文件。

缓存的行为由持续时间和 CacheExpirationPolicy 设置的组合控制。 如果 CacheExpirationPolicy 设置为 Absolute,则 XmlDataSource 控件在第一个数据检索操作中缓存数据,将其保留在内存中指定 CacheDuration的时间量,并在时间过后使数据失效。 然后,在下次操作时刷新缓存。 如果 CacheExpirationPolicy 设置为 Sliding,则数据源控件在第一次数据检索操作中缓存数据,但在每次后续操作时,将重置保留缓存的时间范围。 仅当自上次数据检索以来没有活动的时间等于 时, CacheDuration 缓存才会过期。

适用于

另请参阅