TreeView.DataBindings Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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 öğesiyle bağlandığını düğüm arasındaki ilişkiyi temsil eden.

Öznitelikler: PersistenceModeAttribute

Örnekler

Bu bölüm iki kod örneği içerir. İlk kod örneği, bir veri öğesiyle 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 öğesiyle 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.xml adlı bir dosyaya kopyalamanız gerekir. Bu örnek yalnızca DataMember bağlamanın özelliğini belirtir. Özelliği de belirterek Depth küçük bir performans artışı 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, 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ını belirterek 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 gösterir. Ölçütler düğüm derinliği, veri üyesi veya her ikisiyle de 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:

Hem TreeNodeBinding derinliği hem de veri üyesini tanımlayan nesne.
TreeNodeBinding Yalnızca derinliği tanımlayan nesne.
TreeNodeBinding Yalnızca veri üyesini tanımlayan nesne.
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 değere bağlanabilen bir TreeNode nesnenin ö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. .

DataBindings Koleksiyon program aracılığıyla doldurulabilse de, 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 getirin TreeView . Ardından, öğeleri belirtmek istediğiniz her ağaç düğümü bağlaması için açma ve kapatma <DataBindings> etiketleri arasına yerleştirin<asp:TreeNodeBinding>.

Denetimin AutoGenerateDataBindings TreeView trueözelliği olarak ayarlanarak veri bağlamaları oluşturulduğunda, oluşturulan PopulateOnDemand bağlamaların özelliği olarak trueayarlanmıştır. Bildirimli olarak PopulateOnDemand oluşturulan veri bağlamalarının özelliği olarak falseayarlanmıştır. Bildirim temelli söz dizimini kullanmak, tek tek veri bağlamalarının davranışını denetlemenize olanak tanır.

Şunlara uygulanır

Aracılığıyla paylaş