TreeView.DataBindings Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene un insieme di oggetti TreeNodeBinding che definiscono la relazione tra un elemento di dati e il nodo a cui si sta effettuando l'associazione.

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

Valore della proprietà

TreeNodeBindingCollection

Oggetto TreeNodeBindingCollection che rappresenta la relazione tra un elemento di dati e il nodo a cui si sta effettuando l'associazione.

Attributi: PersistenceModeAttribute

Esempio

In questa sezione sono riportati due esempi di codice. Nel primo esempio di codice viene illustrato come usare la DataBindings raccolta per definire la relazione tra un elemento di dati e il nodo a cui è a sua volta a cui è a binding. Nel secondo esempio di codice vengono forniti dati XML di esempio per il primo esempio di codice.

Nell'esempio di codice seguente viene illustrato come usare la DataBindings raccolta per definire la relazione tra un elemento di dati e il nodo a cui è a sua capo. Per il corretto funzionamento di questo esempio, è necessario copiare i dati XML di esempio, forniti dopo questo esempio di codice, in un file denominato Book.xml. In questo esempio viene specificata solo la DataMember proprietà dell'associazione. È possibile aggiungere un lieve miglioramento delle prestazioni specificando anche la Depth proprietà .


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

Nell'esempio di codice seguente vengono forniti dati XML di esempio per l'esempio precedente.

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

Commenti

L'insieme DataBindings contiene TreeNodeBinding oggetti che definiscono la relazione tra un elemento di dati e il nodo a cui è a cui è a binding. Quando si esegue il binding a un'origine dati in cui ogni elemento di dati contiene più proprietà , ad esempio un elemento XML con diversi attributi, un nodo visualizza il valore restituito dal ToString metodo dell'elemento di dati, per impostazione predefinita. Nel caso di un elemento XML, il nodo visualizza il nome dell'elemento, che mostra la struttura sottostante dell'albero, ma non è molto utile in caso contrario. È possibile associare un nodo a una proprietà specifica dell'elemento di dati specificando le associazioni dei nodi della struttura ad albero.

Quando si definisce la relazione tra un elemento di dati e un nodo, è necessario specificare sia i criteri per l'associazione che i valori da associare alle proprietà dell'oggetto TreeNode . I criteri indicano quando un elemento dati deve essere associato a un nodo. I criteri possono essere specificati con una profondità del nodo, un membro dati o entrambi. Una profondità del nodo specifica il livello di nodo associato. Ad esempio, se si specifica una profondità del nodo pari a 0, tutti i nodi nella struttura ad albero al livello 0 vengono associati usando l'associazione del nodo della struttura ad albero. Un membro dati specifica il tipo dell'elemento di dati nell'origine dati sottostante, ma può rappresentare informazioni diverse a seconda dell'origine dati. Ad esempio, il membro dati per un elemento XML specifica il nome dell'elemento.

Se vengono definiti più TreeNodeBinding oggetti in conflitto tra loro, il TreeView controllo applica le associazioni dei nodi della struttura ad albero nell'ordine di precedenza seguente:

Oggetto TreeNodeBinding che definisce sia una profondità che un membro dati.
Oggetto TreeNodeBinding che definisce solo la profondità.
Oggetto TreeNodeBinding che definisce solo il membro dati.
Oggetto TreeNodeBinding che non definisce né la profondità né il membro dati.

Se vengono specificate più associazioni che soddisfano gli stessi criteri di precedenza, viene applicata la prima associazione nella raccolta.

Dopo aver stabilito i criteri di associazione, è possibile associare una proprietà di un TreeNode oggetto che può essere associato a un valore. È possibile eseguire il binding a un attributo o a un campo di un elemento di dati o visualizzare un valore statico. Per altre informazioni sull'associazione delle proprietà di un TreeNode oggetto a un valore, vedere TreeNodeBinding.

Anche se la DataBindings raccolta può essere popolata a livello di codice, viene in genere impostata in modo dichiarativo. Per specificare le associazioni dei nodi della struttura ad albero, annidare prima i tag di apertura e chiusura <DataBindings> tra i tag di apertura e chiusura del TreeView controllo. Posizionare <asp:TreeNodeBinding> quindi gli elementi tra i tag di apertura e chiusura <DataBindings> per ogni associazione di nodi della struttura ad albero da specificare.

Quando i data binding vengono creati impostando la AutoGenerateDataBindings proprietà del TreeView controllo su true, le associazioni create hanno la PopulateOnDemand proprietà impostata su true. I data binding creati in modo dichiarativo hanno la PopulateOnDemand proprietà impostata su false. L'uso della sintassi dichiarativa consente di controllare il comportamento dei singoli data binding.

Si applica a