XmlDataSource.EnableCaching 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 einen Wert ab, der angibt, ob für das XmlDataSource-Steuerelement die Zwischenspeicherung von Daten aktiviert ist, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, wenn die Zwischenspeicherung von Daten für das Datenquellen-Steuerelement aktiviert ist, andernfalls false. Der Standardwert ist true.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Das Zwischenspeichern beim Verwenden des XmlDataSource Steuerelements zum Anzeigen von Daten in einer XML-Datei aktiviert wird. Das Zwischenspeichern ist aktiviert, wenn die EnableCaching Eigenschaft auf die CacheDuration Anzahl der Sekunden festgelegt true ist, auf 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 weist die folgenden Daten auf:

<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 automatisch Daten zwischen, wenn die EnableCaching Eigenschaft auf true". Standardmäßig wird die CacheDuration Eigenschaft auf 0 festgelegt, was einen unbefristeten Cache angibt, und die Datenquelle speichert Daten zwischen, bis die XML-Datei, von der sie abhängig ist, geändert wird. Wenn Sie die Eigenschaft auf einen Wert festlegen, der CacheDuration größer als 0 ist, speichert der Cache Daten für diese anzahl Sekunden, bevor ein neuer Satz abgerufen wird.

Wenn die EnableCaching Eigenschaft festgelegt ist und die TransformArgumentList Eigenschaft festgelegt true wird, werden die Cacheeinträge nicht automatisch ungültig, wenn sich die Parameter in der Transformationsargumentliste ändern. In diesem Fall müssen Sie Code schreiben, um den Cache zu ungültig machen, indem Sie die CacheKeyDependency Eigenschaft festlegen.

Gilt für

Freigeben über