XmlDataSource.CacheDuration Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define o tempo, em segundos, em que o controlo de fontes de dados armazena em cache os dados que recuperou.

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

Valor de Propriedade

Int32

O número de segundos em que o XmlDataSource controlo armazena em cache os resultados de uma operação de recuperação de dados. O valor padrão é 0.

Atributos
TypeConverterAttribute

Exemplos

O exemplo de código seguinte demonstra como ativar a cache ao usar o XmlDataSource controlo para exibir dados contidos num ficheiro XML. A cache é ativada quando a EnableCaching propriedade é definida como true e o CacheDuration é definido para o número de segundos em que os dados são armazenados em cache pelo controlo de fonte de dados.

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

O ficheiro XML no exemplo de código tem os seguintes dados:

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

Observações

O XmlDataSource controlo armazena automaticamente os dados em cache quando se aplica o seguinte:

  • A propriedade EnableCaching está definida como true.

  • A CacheDuration propriedade é definida para um valor superior a 0, o que indica o número de segundos em que a cache armazena dados antes de ser invalidada.

Qualquer alteração à Data propriedade ou ao conteúdo do ficheiro que contenha os dados XML faz com que a cache seja invalidada.

Por defeito, a CacheDuration propriedade está definida para 0, o que indica uma cache indefinida, e a fonte de dados irá armazenar dados em cache até que o ficheiro XML de que depende seja alterado.

O comportamento da cache é governado por uma combinação da duração e da CacheExpirationPolicy definição. Se CacheExpirationPolicy for definido para Absolute, o XmlDataSource controlo armazena em cache os dados na primeira operação de recuperação de dados, mantém-nos na memória durante o tempo especificado por CacheDuration, e invalida-os após o tempo decorrido. A cache é então atualizada na operação seguinte. Se CacheExpirationPolicy for definido para Sliding, o controlo de fonte de dados armazena em cache os dados na primeira operação de recuperação de dados, mas reinicia a janela temporal para a qual guarda a cache em cada operação subsequente. A cache só expira se não houver atividade durante um tempo igual ao CacheDuration desde a última recuperação de dados.

Aplica-se a

Ver também