TreeView.DataBindings Eigenschaft

Definition

Ruft eine Auflistung von TreeNodeBinding-Objekten ab, die die Beziehung zwischen einem Datenelement und dem Knoten, an den es gebunden werden soll, definieren.Gets a collection of TreeNodeBinding objects that define the relationship between a data item and the node that it is binding to.

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; }
member this.DataBindings : System.Web.UI.WebControls.TreeNodeBindingCollection
Public ReadOnly Property DataBindings As TreeNodeBindingCollection

Eigenschaftswert

Eine TreeNodeBindingCollection, die die Beziehung zwischen einem Datenelement und dem Knoten darstellt, an den es gebunden werden soll.A TreeNodeBindingCollection that represents the relationship between a data item and the node that it is binding to.

Attribute

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele.This section contains two code examples. Im ersten Codebeispiel wird veranschaulicht, wie die DataBindings -Auflistung verwendet wird, um die Beziehung zwischen einem Datenelement und dem Knoten zu definieren, an den es gebunden wird.The first code example demonstrates how to use the DataBindings collection to define the relationship between a data item and the node that it is binding to. Im zweiten Codebeispiel werden Beispiel-XML-Daten für das erste Codebeispiel bereitstellt.The second code example provides sample XML data for the first code example.

Im folgenden Codebeispiel wird veranschaulicht, wie die DataBindings -Auflistung verwendet wird, um die Beziehung zwischen einem Datenelement und dem Knoten zu definieren, an den es gebunden wird.The following code example demonstrates how to use the DataBindings collection to define the relationship between a data item and the node that it is binding to. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die Beispiel-XML-Daten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei namens "Book. xml" kopieren.For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named Book.xml. In diesem Beispiel wird nur DataMember die-Eigenschaft der Bindung angegeben.This example specifies only the DataMember property of the binding. Ein geringfügiger Leistungsgewinn konnte durch Angeben der Depth -Eigenschaft hinzugefügt werden.A slight performance gain could be added by also specifying the Depth property.


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

Das folgende Codebeispiel enthält Beispiel-XML-Daten für das vorherige Beispiel.The following code example provides sample XML data for the preceding example.

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

Hinweise

Die DataBindings -Auflistung TreeNodeBinding enthält-Objekte, die die Beziehung zwischen einem Datenelement und dem Knoten definieren, an den er gebunden ist.The DataBindings collection contains TreeNodeBinding objects that define the relationship between a data item and the node that it is binding to. Beim Binden an eine Datenquelle, in der jedes Datenelement mehrere Eigenschaften enthält (z. b. ein XML-Element mit mehreren Attributen), zeigt ein Knoten den Wert ToString an, der von der-Methode des Datenelements standardmäßig zurückgegeben wird.When binding to a data source where each data item contains multiple properties (such as an XML element with several attributes), a node displays the value that is returned by the ToString method of the data item, by default. Im Fall eines XML-Elements zeigt der Knoten den Elementnamen an, der die zugrunde liegende Struktur der Struktur anzeigt, aber andernfalls nicht sehr nützlich ist.In the case of an XML element, the node displays the element name, which shows the underlying structure of the tree, but is not very useful otherwise. Sie können einen Knoten an eine bestimmte Datenelement Eigenschaft binden, indem Sie Struktur Knoten Bindungen angeben.You can bind a node to a specific data item property by specifying tree node bindings.

Wenn Sie die Beziehung zwischen einem Datenelement und einem Knoten definieren, müssen Sie sowohl die Kriterien für die Bindung als auch die Werte angeben, die an TreeNode die Eigenschaften des Objekts gebunden werden sollen.When defining the relationship between a data item and a node, you must specify both the criteria for binding and the values to bind to the properties of TreeNode object. Die Kriterien geben an, wann ein Datenelement an einen Knoten gebunden werden soll.The criteria indicate when a data item should be bound to a node. Die Kriterien können mit einer Knoten Tiefe, einem Datenmember oder beidem angegeben werden.The criteria can be specified with a node depth, a data member, or both. Eine Knoten Tiefe gibt die Knotenebene an, die gebunden wird.A node depth specifies the node level that gets bound. Wenn Sie z. b. eine Knoten Tiefe von 0 angeben, werden alle Knoten in der Baumstruktur auf Ebene 0 mithilfe der Struktur Knoten Bindung gebunden.For example, if you specify a node depth of 0, all nodes in the tree structure at level 0 are bound using the tree node binding. Ein Datenmember gibt den Typ des Datenelements in der zugrunde liegenden Datenquelle an, kann jedoch unterschiedliche Informationen darstellen, abhängig von der Datenquelle.A data member specifies the type of the data item in the underlying data source, but can represent different information depending on the data source. Der-Datenmember für ein XML-Element gibt z. b. den Namen des Elements an.For example, the data member for an XML element specifies the name of the element.

Wenn mehrere TreeNodeBinding Objekte definiert sind, die miteinander in Konflikt stehen, TreeView wendet das Steuerelement die Struktur Knoten Bindungen in der folgenden Rangfolge an:If multiple TreeNodeBinding objects are defined that conflict with each other, the TreeView control applies the tree node bindings in the following order of precedence:

  1. Das TreeNodeBinding -Objekt, das eine Tiefe und einen Datenmember definiert.The TreeNodeBinding object that defines both a depth and a data member.

  2. Das TreeNodeBinding -Objekt, das nur die Tiefe definiert.The TreeNodeBinding object that defines only the depth.

  3. Das TreeNodeBinding -Objekt, das nur den Datenmember definiert.The TreeNodeBinding object that defines only the data member.

  4. Das TreeNodeBinding -Objekt, das weder die Tiefe noch den Datenmember definiert.The TreeNodeBinding object that defines neither the depth nor the data member.

Wenn mehrere Bindungen angegeben werden, die dieselben Rang Folge Kriterien erfüllen, wird die erste Bindung in der Auflistung angewendet.If multiple bindings are specified that meet the same precedence criteria, the first binding in the collection is applied.

Nachdem Sie die Bindungs Kriterien festgelegt haben, können Sie eine Eigenschaft eines TreeNode -Objekts binden, die an einen-Wert gebunden werden kann.Once the binding criteria is established, you can then bind a property of a TreeNode object that can be bound to a value. Sie können entweder eine Bindung an ein Attribut oder Feld eines Datenelements oder einen statischen Wert durchführen.You can either bind to an attribute or field of a data item or display a static value. Weitere Informationen zum Binden der Eigenschaften eines TreeNode -Objekts an einen-Wert finden TreeNodeBindingSie unter.For more information on binding the properties of a TreeNode object to a value, see TreeNodeBinding.

Obwohl die DataBindings Auflistung Programm gesteuert aufgefüllt werden kann, wird Sie normalerweise deklarativ festgelegt.Although the DataBindings collection can be programmatically populated, it is usually set declaratively. Um die Struktur Knoten Bindungen anzugeben, Schachteln Sie zuerst öffnende <DataBindings> und schließende Tags zwischen dem öffnenden und TreeView dem schließenden Tag des Steuer Elements.To specify the tree node bindings, first nest opening and closing <DataBindings> tags between the opening and closing tags of the TreeView control. Platzieren <asp:TreeNodeBinding> Sie als nächstes Elemente zwischen den öffnenden <DataBindings> und schließenden Tags für jede Struktur Knoten Bindung, die Sie angeben möchten.Next, place <asp:TreeNodeBinding> elements between the opening and closing <DataBindings> tags for each tree node binding you want to specify.

Wenn Daten Bindungen erstellt werden, indem die AutoGenerateDataBindings -Eigenschaft TreeView des-Steuer trueElements auf festgelegt wird, wird bei PopulateOnDemand den erstellten Bindungen truedie-Eigenschaft auf festgelegt.When data bindings are created by setting the AutoGenerateDataBindings property of the TreeView control to true, the bindings that are created have the PopulateOnDemand property set to true. Daten Bindungen, die deklarativ erstellt werden, PopulateOnDemand haben die- falseEigenschaft auf festgelegt.Data bindings that are created declaratively have the PopulateOnDemand property set to false. Mithilfe der deklarativen Syntax können Sie das Verhalten einzelner Daten Bindungen steuern.Using the declarative syntax allows you to control the behavior of individual data bindings.

Gilt für:

Siehe auch