TreeView.DataBindings Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft eine Auflistung von TreeNodeBinding-Objekten ab, die die Beziehung zwischen einem Datenelement und dem Knoten, an den es gebunden werden soll, definieren.

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

Eigenschaftswert

TreeNodeBindingCollection

Eine TreeNodeBindingCollection, die die Beziehung zwischen einem Datenelement und dem Knoten darstellt, an den es gebunden werden soll.

Attribute: PersistenceModeAttribute

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie Sie die DataBindings Auflistung verwenden, um die Beziehung zwischen einem Datenelement und dem Knoten zu definieren, an den sie gebunden ist. Im zweiten Codebeispiel werden Beispiel-XML-Daten für das erste Codebeispiel bereitgestellt.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die DataBindings Auflistung verwenden, um die Beziehung zwischen einem Datenelement und dem Knoten zu definieren, an den sie gebunden ist. In diesem Beispiel müssen Sie die Beispiel-XML-Daten, die nach diesem Codebeispiel angegeben sind, in eine Datei mit dem Namen Book.xml kopieren. In diesem Beispiel wird nur die DataMember Eigenschaft der Bindung angegeben. Ein leichtes Leistungsgewinn könnte hinzugefügt werden, indem auch die Depth Eigenschaft angegeben wird.


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

Im folgenden Codebeispiel werden Beispiel-XML-Daten für das vorherige Beispiel bereitgestellt.

<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 enthält TreeNodeBinding Objekte, die die Beziehung zwischen einem Datenelement und dem Knoten definieren, an den sie gebunden ist. 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 an, der von der ToString Methode des Datenelements zurückgegeben wird, standardmäßig. Im Falle eines XML-Elements zeigt der Knoten den Elementnamen an, der die zugrunde liegende Struktur der Struktur anzeigt, aber nicht sehr nützlich ist. Sie können einen Knoten an eine bestimmte Datenelementeigenschaft binden, indem Sie Strukturknotenbindungen angeben.

Beim Definieren der Beziehung zwischen einem Datenelement und einem Knoten müssen Sie sowohl die Kriterien für die Bindung als auch die Werte angeben, die an die Eigenschaften des TreeNode Objekts gebunden werden sollen. Die Kriterien geben an, wann ein Datenelement an einen Knoten gebunden werden soll. Die Kriterien können mit einer Knotentiefe, einem Datenmitglied oder beidem angegeben werden. Eine Knotentiefe gibt die Knotenebene an, die gebunden wird. Wenn Sie z. B. eine Knotentiefe von 0 angeben, werden alle Knoten in der Struktur auf Ebene 0 mit der Strukturknotenbindung gebunden. Ein Datenelement gibt den Typ des Datenelements in der zugrunde liegenden Datenquelle an, kann jedoch je nach Datenquelle unterschiedliche Informationen darstellen. Beispielsweise gibt das Datenelement für ein XML-Element den Namen des Elements an.

Wenn mehrere TreeNodeBinding Objekte definiert sind, die miteinander in Konflikt stehen, wendet das TreeView Steuerelement die Strukturknotenbindungen in der folgenden Reihenfolge der Rangfolge an:

Das TreeNodeBinding Objekt, das sowohl eine Tiefe als auch ein Datenelement definiert.
Das TreeNodeBinding Objekt, das nur die Tiefe definiert.
Das TreeNodeBinding Objekt, das nur das Datenelement definiert.
Das TreeNodeBinding Objekt, das weder die Tiefe noch das Datenelement definiert.

Wenn mehrere Bindungen angegeben werden, die dieselben Vorrangkriterien erfüllen, wird die erste Bindung in der Auflistung angewendet.

Nachdem die Bindungskriterien eingerichtet wurden, können Sie dann eine Eigenschaft eines TreeNode Objekts binden, das an einen Wert gebunden werden kann. Sie können entweder an ein Attribut oder ein Feld eines Datenelements binden oder einen statischen Wert anzeigen. Weitere Informationen zum Binden der Eigenschaften eines TreeNode Objekts auf einen Wert finden Sie unter TreeNodeBinding.

Obwohl die Auflistung programmgesteuert gefüllt werden kann, wird sie in der DataBindings Regel deklarativ festgelegt. Um die Strukturknotenbindungen anzugeben, öffnen und schließen sie zuerst zwischen den öffnenden und schließenden <DataBindings> Tags des TreeView Steuerelements. Platzieren Sie <asp:TreeNodeBinding> als Nächstes Elemente zwischen den öffnenden und schließenden <DataBindings> Tags für jede Strukturknotenbindung, die Sie angeben möchten.

Wenn Datenbindungen erstellt werden, indem Sie die AutoGenerateDataBindings Eigenschaft des TreeView Steuerelements trueauf festlegen, sind die Bindungen, die erstellt werden, mit der PopulateOnDemand Eigenschaft festgelegt true. Datenbindungen, die deklarativ erstellt werden, weisen die PopulateOnDemand Eigenschaft auf false. Mithilfe der deklarativen Syntax können Sie das Verhalten einzelner Datenbindungen steuern.

Gilt für

Freigeben über