Nyelv

TreeView.DataBindings Tulajdonság

Definíció

Névtér:
System.Web.UI.WebControls
Szerelvény:
System.Web.dll

Olyan objektumgyűjteményt TreeNodeBinding kap, amely meghatározza az adatelem és a csomópont közötti kapcsolatot, amelyhez kötést fűz.

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

Tulajdonság értéke

TreeNodeBindingCollection

Az TreeNodeBindingCollection adatelem és a csomópont közötti kapcsolatot jelképező érték, amelyhez kötést fűz.

Attribútumok
PersistenceModeAttribute

Példák

Ez a szakasz két példakódot tartalmaz. Az első példakód bemutatja, hogyan használható a gyűjtemény az DataBindings adatelem és a csomópont közötti kapcsolat meghatározására. A második példa xml-mintaadatokat biztosít az első kód példájához.

Az alábbi példakód bemutatja, hogyan használható a gyűjtemény az DataBindings adatelem és a csomópont közötti kapcsolat meghatározására, amelyhez kötést használ. Ahhoz, hogy ez a példa megfelelően működjön, a példakód után megadott XML-mintaadatokat egy Book.xmlnevű fájlba kell másolnia. Ez a példa csak a DataMember kötés tulajdonságát adja meg. A tulajdonság megadásával Depth enyhe teljesítménynövekedést is hozzáadhat.


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

Az alábbi példakód az előző példához tartozó XML-mintaadatokat tartalmazza.

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

Megjegyzések

A DataBindings gyűjtemény olyan objektumokat tartalmaz TreeNodeBinding , amelyek meghatározzák az adatelem és a csomópont közötti kapcsolatot, amelyhez kötést fűz. Ha olyan adatforráshoz köt, amelyben minden adatelem több tulajdonságot tartalmaz (például egy XML-elemet több attribútummal), a csomópont alapértelmezés szerint megjeleníti az ToString adatelem metódusa által visszaadott értéket. XML-elem esetén a csomópont megjeleníti az elem nevét, amely a fa mögöttes szerkezetét mutatja, máskülönben azonban nem túl hasznos. A csomópontokat egy adott adatelem-tulajdonsághoz kötheti facsomópont-kötések megadásával.

Az adatelem és a csomópont közötti kapcsolat meghatározásakor meg kell adnia a kötés feltételeit és az objektum tulajdonságaihoz TreeNode kötéshez szükséges értékeket is. A feltételek azt jelzik, hogy mikor kell egy adatelemet csomóponthoz kötni. A feltételek megadhatóak csomópontmélységgel, adattaggal vagy mindkettővel. A csomópontmélység határozza meg a kötött csomópontszintet. Ha például 0-s csomópontmélység van megadva, a faszerkezet 0. szintjén lévő összes csomópont a facsomópont kötésével van kötve. Az adattagok az alapul szolgáló adatforrás adatelemének típusát határozzák meg, de az adatforrástól függően különböző információkat is képviselhetnek. Egy XML-elem adattagja például az elem nevét adja meg.

Ha több TreeNodeBinding objektum van definiálva, amelyek ütköznek egymással, a vezérlő a TreeView facsomópont-kötéseket a következő sorrendben alkalmazza:

  1. A TreeNodeBinding mélységet és az adattagot egyaránt meghatározó objektum.

  2. A TreeNodeBinding csak a mélységet meghatározó objektum.

  3. Az TreeNodeBinding az objektum, amely csak az adattagot határozza meg.

  4. Az TreeNodeBinding az objektum, amely nem határozza meg sem a mélységet, sem az adattagot.

Ha több kötés van megadva, amelyek megfelelnek az azonos prioritási feltételeknek, a rendszer alkalmazza a gyűjtemény első kötését.

A kötési feltételek meghatározása után egy értékhez kötött objektum tulajdonságát TreeNode kötheti össze. Kapcsolódhat egy adatelem attribútumához vagy mezőjéhez, vagy megjeleníthet egy statikus értéket. Az objektum tulajdonságainak értékhez kötéséről TreeNode további információt a következő témakörben talál TreeNodeBinding: .

Bár a DataBindings gyűjtemény programozott módon is kitölthető, általában deklaratív módon van beállítva. A facsomópont-kötések megadásához először a vezérlő nyitó és záró címkéi között ágyazzuk be a nyitó és a <DataBindings> záró TreeView címkéket. Ezután helyezze az <asp:TreeNodeBinding> elemeket a megnyitni kívánt csomópontkötések nyitó és záró <DataBindings> címkéi közé.

Ha az adatkötések a vezérlőelem AutoGenerateDataBindingstulajdonságának TreeView beállításával true jönnek létre, a létrehozott kötések tulajdonsága a PopulateOnDemand következőre truevan állítva: . A deklaratív módon létrehozott adatkötések tulajdonsága a PopulateOnDemand következőre falsevan állítva: . A deklaratív szintaxissal szabályozhatja az egyes adatkötések viselkedését.

A következőre érvényes:

Lásd még