TreeView.DataBindings 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 uma coleção de TreeNodeBinding objetos que definem a relação entre um item de dados e o nó ao qual ele está se associando.

public:
 property System::Web::UI::WebControls::TreeNodeBindingCollection ^ DataBindings { System::Web::UI::WebControls::TreeNodeBindingCollection ^ get(); };

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.TreeNodeBindingCollection DataBindings { get; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.DataBindings : System.Web.UI.WebControls.TreeNodeBindingCollection

Public ReadOnly Property DataBindings As TreeNodeBindingCollection

Valor da propriedade

TreeNodeBindingCollection

Um TreeNodeBindingCollection que representa a relação entre um item de dados e o nó ao qual ele está se associando.

Atributos: PersistenceModeAttribute

Exemplos

Esta seção contém dois exemplos de código. O primeiro exemplo de código demonstra como usar a DataBindings coleção para definir a relação entre um item de dados e o nó ao qual ele está associando. O segundo exemplo de código fornece dados XML de exemplo para o primeiro exemplo de código.

O exemplo de código a seguir demonstra como usar a DataBindings coleção para definir a relação entre um item de dados e o nó ao qual ela está vinculando. Para que este exemplo funcione corretamente, você deve copiar os dados XML de exemplo, fornecidos após este exemplo de código, para um arquivo chamado Book.xml. Este exemplo especifica apenas a DataMember propriedade da associação. Um pequeno ganho de desempenho pode ser adicionado especificando também a Depth propriedade.


<%@ 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>TreeView XML Data Binding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView XML Data Binding Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>

      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
    
    </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>TreeView XML Data Binding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView XML Data Binding Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>

      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

O exemplo de código a seguir fornece dados XML de exemplo para o exemplo anterior.

<Book Title="Book Title">
    <Chapter Heading="Chapter 1">
        <Section Heading="Section 1">
        </Section>
        <Section Heading="Section 2">
        </Section>
    </Chapter>
    <Chapter Heading="Chapter 2">
        <Section Heading="Section 1">
        </Section>
    </Chapter>
</Book>

Comentários

A DataBindings coleção contém TreeNodeBinding objetos que definem a relação entre um item de dados e o nó ao qual está vinculando. Ao associar a uma fonte de dados em que cada item de dados contém várias propriedades (como um elemento XML com vários atributos), um nó exibe o valor retornado pelo ToString método do item de dados, por padrão. No caso de um elemento XML, o nó exibe o nome do elemento, que mostra a estrutura subjacente da árvore, mas não é muito útil de outra forma. Você pode associar um nó a uma propriedade de item de dados específica especificando associações de nó de árvore.

Ao definir a relação entre um item de dados e um nó, você deve especificar os critérios de associação e os valores a serem associados às propriedades do TreeNode objeto. Os critérios indicam quando um item de dados deve ser associado a um nó. Os critérios podem ser especificados com uma profundidade de nó, um membro de dados ou ambos. Uma profundidade de nó especifica o nível do nó que é associado. Por exemplo, se você especificar uma profundidade de nó de 0, todos os nós na estrutura da árvore no nível 0 serão associados usando a associação de nó de árvore. Um membro de dados especifica o tipo do item de dados na fonte de dados subjacente, mas pode representar informações diferentes dependendo da fonte de dados. Por exemplo, o membro de dados de um elemento XML especifica o nome do elemento.

Se vários TreeNodeBinding objetos forem definidos que entram em conflito entre si, o TreeView controle aplicará as associações de nó de árvore na seguinte ordem de precedência:

O TreeNodeBinding objeto que define uma profundidade e um membro de dados.
O TreeNodeBinding objeto que define apenas a profundidade.
O TreeNodeBinding objeto que define apenas o membro de dados.
O TreeNodeBinding objeto que não define nem a profundidade nem o membro de dados.

Se forem especificadas várias associações que atendam aos mesmos critérios de precedência, a primeira associação da coleção será aplicada.

Depois que os critérios de associação forem estabelecidos, você poderá associar uma propriedade de um TreeNode objeto que pode ser associada a um valor. Você pode associar a um atributo ou campo de um item de dados ou exibir um valor estático. Para obter mais informações sobre como associar as propriedades de um TreeNode objeto a um valor, consulte TreeNodeBinding.

Embora a DataBindings coleção possa ser preenchida programaticamente, ela geralmente é definida declarativamente. Para especificar as associações de nó de árvore, primeiro aninhar marcas de abertura e fechamento <DataBindings> entre as marcas de abertura e fechamento do TreeView controle. Em seguida, coloque <asp:TreeNodeBinding> elementos entre as marcas de abertura e fechamento <DataBindings> para cada associação de nó de árvore que você deseja especificar.

Quando as associações de dados são criadas definindo a AutoGenerateDataBindings propriedade do TreeView controle como true, as associações criadas têm a PopulateOnDemand propriedade definida como true. As associações de dados criadas declarativamente têm a PopulateOnDemand propriedade definida como false. O uso da sintaxe declarativa permite controlar o comportamento das associações de dados individuais.

Aplica-se a