XmlDataSource.CacheDuration Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define o período de tempo, em segundos, em que o controle de fonte de dados armazena em cache os dados que recupera.

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

Int32

O número de segundos que o XmlDataSource controle 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 a seguir demonstra como habilitar o cache ao usar o XmlDataSource controle para exibir dados contidos em um arquivo XML. Caching está habilitada quando a EnableCaching propriedade está definida true e o CacheDuration conjunto é definido como o número de segundos em que os dados são armazenados em cache pelo controle da 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 arquivo 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>

Comentários

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

A propriedade EnableCaching está definida como true.
A CacheDuration propriedade é definida como um valor maior que 0, o que indica o número de segundos que o cache armazena dados antes que o cache seja invalidado.

Qualquer alteração na Data propriedade ou no conteúdo do arquivo que contém os dados XML faz com que o cache seja invalidado.

Por padrão, a CacheDuration propriedade é definida como 0, o que indica um cache indefinido e a fonte de dados armazenará os dados em cache até que o arquivo XML do qual ele depende seja alterado.

O comportamento do cache é regido por uma combinação da duração e da CacheExpirationPolicy configuração. Se CacheExpirationPolicy estiver definido como Absolute, o XmlDataSource controle armazena dados em cache na primeira operação de recuperação de dados, mantém-os na memória pelo período de tempo especificado e CacheDurationinvalida-os após o término do tempo. Em seguida, o cache é atualizado na próxima operação. Se CacheExpirationPolicy for definido como Sliding, o controle da fonte de dados armazena dados em cache na primeira operação de recuperação de dados, mas redefine a janela de tempo para a qual ele mantém o cache em cada operação subsequente. O cache só expirará se não houver atividade por um tempo igual ao CacheDuration da última recuperação de dados.

Aplica-se a

Partilhar via