XmlDataSource.CacheDuration Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Zeitspanne in Sekunden ab, in der das Datenquellen-Steuerelement abgerufene Daten zwischenspeichert, oder legt diese fest.

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

Eigenschaftswert

Int32

Die Anzahl von Sekunden, für die das XmlDataSource-Steuerelement die Ergebnisse eines Datenabrufvorgangs zwischenspeichert. Der Standardwert ist 0.

Attribute: TypeConverterAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Zwischenspeicherung aktivieren, wenn Sie das -Steuerelement zum Anzeigen von XmlDataSource Daten in einer XML-Datei verwenden. Die Zwischenspeicherung ist aktiviert, wenn die EnableCaching -Eigenschaft auf true festgelegt ist und auf CacheDuration die Anzahl von Sekunden festgelegt ist, die die Daten vom Datenquellensteuerelement zwischengespeichert werden.

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

Die XML-Datei im Codebeispiel enthält die folgenden Daten:

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

Hinweise

Das XmlDataSource Steuerelement speichert Daten automatisch zwischen, wenn Folgendes zutrifft:

Die EnableCaching-Eigenschaft ist auf true festgelegt.
Die CacheDuration Eigenschaft ist auf einen Wert größer als 0 festgelegt, der angibt, wie viele Sekunden der Cache Daten speichert, bevor der Cache ungültig wird.

Jede Änderung der Data Eigenschaft oder des Inhalts der Datei, die die XML-Daten enthält, führt dazu, dass der Cache ungültig wird.

Standardmäßig ist die CacheDuration Eigenschaft auf 0 festgelegt, was einen unbegrenzten Cache angibt, und die Datenquelle speichert Daten zwischen, bis die XML-Datei, von der sie abhängt, geändert wird.

Das Verhalten des Caches wird durch eine Kombination aus Dauer und CacheExpirationPolicy Einstellung gesteuert. Wenn CacheExpirationPolicy auf Absolutefestgelegt ist, speichert das XmlDataSource Steuerelement Daten für den ersten Datenabrufvorgang zwischen, speichert sie für die von CacheDurationangegebene Zeit im Arbeitsspeicher und ungültig, nachdem die Zeit abgelaufen ist. Der Cache wird dann beim nächsten Vorgang aktualisiert. Wenn CacheExpirationPolicy auf Slidingfestgelegt ist, speichert die Datenquellensteuerung Daten beim ersten Datenabrufvorgang zwischen, setzt jedoch das Zeitfenster zurück, für das sie den Cache enthält, bei jedem nachfolgenden Vorgang. Der Cache läuft nur ab, wenn seit dem letzten Datenabruf keine Aktivität mehr vorhanden CacheDuration ist.

Gilt für:

Freigeben über