Aracılığıyla paylaş

TreeView.DataBindings Özellik

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Bir veri öğesiyle bağlandığınız düğüm arasındaki ilişkiyi tanımlayan nesne koleksiyonunu TreeNodeBinding alır.

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

Özellik Değeri

TreeNodeBindingCollection

Bir TreeNodeBindingCollection veri öğesi ile bağlandığını düğüm arasındaki ilişkiyi temsil eden bir.

Öznitelikler
PersistenceModeAttribute

Örnekler

Bu bölüm iki kod örneği içerir. İlk kod örneği, bir veri öğesi ile bağlandığınız düğüm arasındaki ilişkiyi tanımlamak için koleksiyonun nasıl kullanılacağını DataBindings gösterir. İkinci kod örneği, ilk kod örneği için örnek XML verileri sağlar.

Aşağıdaki kod örneği, bir veri öğesi ile bağlandığınız düğüm arasındaki ilişkiyi tanımlamak için koleksiyonun nasıl kullanılacağını DataBindings gösterir. Bu örneğin doğru çalışması için, bu kod örneğinden sonra sağlanan örnek XML verilerini Book.xmladlı bir dosyaya kopyalamanız gerekir. Bu örnek yalnızca bağlamanın DataMember özelliğini belirtir. Ayrıca özelliği belirtilerek Depth küçük bir performans kazancı eklenebilir.


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

Aşağıdaki kod örneği, önceki örnek için örnek XML verileri sağlar.

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

Açıklamalar

Koleksiyon, DataBindings bir veri öğesiyle bağlandığınız düğüm arasındaki ilişkiyi tanımlayan nesneler içerir TreeNodeBinding . Her veri öğesinin birden çok özellik (çeşitli özniteliklere sahip bir XML öğesi gibi) içerdiği bir veri kaynağına bağlanırken, bir düğüm varsayılan olarak veri öğesinin yöntemi tarafından ToString döndürülen değeri görüntüler. XML öğesi söz konusu olduğunda düğüm, ağacın temel yapısını gösteren öğe adını görüntüler, ancak aksi takdirde çok kullanışlı değildir. Ağaç düğümü bağlamaları belirterek bir düğümü belirli bir veri öğesi özelliğine bağlayabilirsiniz.

Veri öğesi ile düğüm arasındaki ilişkiyi tanımlarken, hem bağlama ölçütlerini hem de nesnenin TreeNode özelliklerine bağlanacak değerleri belirtmeniz gerekir. Ölçütler, bir veri öğesinin düğüme ne zaman bağlanması gerektiğini belirtir. Ölçütler düğüm derinliği, veri üyesi veya her ikisi ile belirtilebilir. Düğüm derinliği, bağlanan düğüm düzeyini belirtir. Örneğin, 0 düğüm derinliği belirtirseniz, 0 düzeyindeki ağaç yapısındaki tüm düğümler ağaç düğümü bağlaması kullanılarak bağlanır. Veri üyesi, temel alınan veri kaynağındaki veri öğesinin türünü belirtir, ancak veri kaynağına bağlı olarak farklı bilgileri temsil edebilir. Örneğin, bir XML öğesinin veri üyesi öğenin adını belirtir.

Birbiriyle çakışan birden çok TreeNodeBinding nesne tanımlanırsa, TreeView denetim ağaç düğümü bağlamalarını aşağıdaki öncelik sırasına göre uygular:

  1. Hem TreeNodeBinding derinliği hem de veri üyesini tanımlayan nesne.

  2. Yalnızca TreeNodeBinding derinliği tanımlayan nesne.

  3. TreeNodeBinding Yalnızca veri üyesini tanımlayan nesne.

  4. Derinliği TreeNodeBinding veya veri üyesini tanımlayan nesne.

Aynı öncelik ölçütlerine uyan birden çok bağlama belirtilirse, koleksiyondaki ilk bağlama uygulanır.

Bağlama ölçütleri oluşturulduktan sonra, bir TreeNode nesnenin bir değere bağlanabilecek bir özelliğini bağlayabilirsiniz. Bir veri öğesinin özniteliğine veya alanına bağlanabilir veya statik bir değer görüntüleyebilirsiniz. Bir nesnenin özelliklerini bir TreeNode değere bağlama hakkında daha fazla bilgi için bkz TreeNodeBinding. .

Koleksiyon program aracılığıyla doldurulabilir ancak DataBindings genellikle bildirim temelli olarak ayarlanır. Ağaç düğümü bağlamalarını belirtmek için, önce açma ve kapatma <DataBindings> etiketlerini denetimin açma ve kapatma etiketleri arasında iç içe koyun TreeView . Ardından, belirtmek istediğiniz her ağaç düğümü bağlaması için açma ve kapatma <DataBindings> etiketleri arasına öğeleri yerleştirin<asp:TreeNodeBinding>.

Denetimin AutoGenerateDataBindingsTreeViewtrueözelliği olarak ayarlanarak veri bağlamaları oluşturulduğunda, oluşturulan PopulateOnDemand bağlamaların özelliği olarak trueayarlanır. Bildirimli olarak PopulateOnDemand oluşturulan veri bağlamalarının özelliği olarak ayarlanmıştır false. Bildirim temelli söz dizimini kullanmak, tek tek veri bağlamalarının davranışını denetlemenize olanak tanır.

Şunlara uygulanır

Ayrıca bkz.