TreeView.DataBindings Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar en samling TreeNodeBinding objekt som definierar relationen mellan ett dataobjekt och den nod som det är bindning till.

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

Egenskapsvärde

TreeNodeBindingCollection

En TreeNodeBindingCollection som representerar relationen mellan ett dataobjekt och den nod som det är bindning till.

Attribut
PersistenceModeAttribute

Exempel

Det här avsnittet innehåller två kodexempel. Det första kodexemplet visar hur du använder DataBindings samlingen för att definiera relationen mellan ett dataobjekt och den nod som den är bindning till. Det andra kodexemplet innehåller XML-exempeldata för det första kodexemplet.

Följande kodexempel visar hur du använder DataBindings samlingen för att definiera relationen mellan ett dataobjekt och den nod som den är bindning till. För att det här exemplet ska fungera korrekt måste du kopiera XML-exempeldata, som tillhandahålls efter det här kodexemplet, till en fil med namnet Book.xml. I det här exemplet anges endast DataMember bindningens egenskap. En liten prestandaökning kan läggas till genom att även ange Depth egenskapen.


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

Följande kodexempel innehåller XML-exempeldata för föregående exempel.

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

Kommentarer

Samlingen DataBindings innehåller TreeNodeBinding objekt som definierar relationen mellan ett dataobjekt och den nod som den är bindning till. När du binder till en datakälla där varje dataobjekt innehåller flera egenskaper (till exempel ett XML-element med flera attribut) visar en nod det värde som returneras av ToString dataobjektets metod som standard. När det gäller ett XML-element visar noden elementnamnet, som visar trädets underliggande struktur, men som annars inte är särskilt användbart. Du kan binda en nod till en specifik dataobjektegenskap genom att ange trädnodbindningar.

När du definierar relationen mellan ett dataobjekt och en nod måste du ange både villkoret för bindning och de värden som ska bindas till objektets TreeNode egenskaper. Villkoret anger när ett dataobjekt ska bindas till en nod. Villkoret kan anges med ett noddjup, en datamedlem eller båda. Ett noddjup anger den nodnivå som binds. Om du till exempel anger ett noddjup på 0 är alla noder i trädstrukturen på nivå 0 bundna med hjälp av trädnodbindningen. En datamedlem anger typen av dataobjekt i den underliggande datakällan, men kan representera olika information beroende på datakällan. Datamedlemmen för ett XML-element anger till exempel namnet på elementet.

Om flera TreeNodeBinding objekt definieras som står i konflikt med varandra tillämpar TreeView kontrollen trädnodbindningarna i följande prioritetsordning:

  1. Objektet TreeNodeBinding som definierar både ett djup och en datamedlem.

  2. Objektet TreeNodeBinding som endast definierar djupet.

  3. Objektet TreeNodeBinding som endast definierar datamedlemmen.

  4. Objektet TreeNodeBinding som varken definierar djupet eller datamedlemmen.

Om flera bindningar anges som uppfyller samma prioritetsvillkor tillämpas den första bindningen i samlingen.

När bindningsvillkoren har upprättats kan du sedan binda en egenskap för ett TreeNode objekt som kan bindas till ett värde. Du kan antingen binda till ett attribut eller fält för ett dataobjekt eller visa ett statiskt värde. Mer information om hur du binder egenskaperna för ett TreeNode objekt till ett värde finns i TreeNodeBinding.

Även om samlingen kan fyllas programmatiskt anges den DataBindings vanligtvis deklarativt. Ange trädnodbindningar genom att först kapsla inledande och avslutande <DataBindings> taggar mellan kontrollens TreeView inledande och avslutande taggar. Placera sedan <asp:TreeNodeBinding> element mellan de inledande och avslutande <DataBindings> taggarna för varje trädnodbindning som du vill ange.

När databindningar skapas genom att ställa in AutoGenerateDataBindings egenskapen TreeView för kontrollen på true, har PopulateOnDemand bindningarna som skapas egenskapen inställd på true. Databindningar som skapas deklarativt har egenskapen inställd på PopulateOnDemandfalse. Med den deklarativa syntaxen kan du styra beteendet för enskilda databindningar.

Gäller för

Se även