Aracılığıyla paylaş

TreeNodeBinding.DataMember Özellik

  • Başvuru

Tanım

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

Ağaç düğümü bağlamasının uygulanıp uygulanmayacağını belirlemek için değeri bir veri öğesinin özelliğiyle eşleşecek Type şekilde alır veya ayarlar.

public:
 property System::String ^ DataMember { System::String ^ get(); void set(System::String ^ value); };
public string DataMember { get; set; }
member this.DataMember : string with get, set
Public Property DataMember As String

Özellik Değeri

String

Ağaç düğümü bağlamasının uygulanıp uygulanmayacağını belirlemek için bir veri öğesinin Type özelliğiyle eşleşecek değer. Varsayılan, özelliğin DataMember ayarlanmadığını gösteren boş bir dizedir ("").

Örnekler

Bu bölüm iki kod örneği içerir. İlk kod örneği, bir düğüme hangi XML öğesinin DataMember bağlanacağını belirtmek için özelliğinin nasıl kullanılacağını gösterir. İkinci kod örneği, ilk kod örneği için örnek XML verileri sağlar.

Aşağıdaki kod örneği, bir düğüme hangi XML öğesinin DataMember bağlanacağını belirtmek için özelliğinin nasıl kullanılacağını gösterir. Bu kod örneğinin düzgün çalışması için, bu kod örneğinden sonra sağlanan örnek XML verilerini Book.xml adlı bir dosyaya kopyalamanız gerekir.


<%@ 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>TreeViewBinding DataMember and Depth Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeViewBinding DataMember and Depth Example</h3>
    
      <!-- Set the DataMember and Depth properties of a -->
      <!-- TreeNodeBinding object declaratively. You  -->
      <!-- can render items at the same node level    -->
      <!-- by setting each item's Depth property to   -->
      <!-- the same value.                -->
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" Depth="0" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" Depth="1" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Appendix" Depth="1" 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>TreeViewBinding DataMember and Depth Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeViewBinding DataMember and Depth Example</h3>
    
      <!-- Set the DataMember and Depth properties of a -->
      <!-- TreeNodeBinding object declaratively. You  -->
      <!-- can render items at the same node level    -->
      <!-- by setting each item's Depth property to   -->
      <!-- the same value.                -->
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" Depth="0" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" Depth="1" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Appendix" Depth="1" 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 kod örneği 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>  
    <Appendix Heading="Appendix A">  
    </Appendix>  
</Book>

Açıklamalar

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. Hiyerarşik veri kaynağındaki (bir System.Web.UI.IHierarchyData nesneyle temsil edilen) her veri öğesi, veri öğesinin türünü belirten bir IHierarchyData.Type özelliği kullanıma sunar. Örneğin, bir XML öğesinin veri üyesi öğenin adını belirtir. Bir veri kaynağı birden çok veri öğesi türü içerdiğinde, veri üyesi hangi veri öğesi türünün kullanılacağını belirtir. Aşağıdaki TreeNodeBinding bildirim, hiyerarşideki <Book> konumdan bağımsız olarak bir XmlDataSource denetimin öğelerini ağaçtaki tüm düğümlere bağlar:

<asp:TreeNodeBinding DataMember="Book" TextField="Title" ValueField= "ISBN">

Nesne TreeNodeBinding oluştururken bağlama ölçütlerini belirtmeniz gerekir. Ölçütler, bir veri öğesinin düğüme ne zaman bağlanması gerektiğini belirtir. veya DataMember özelliğini veya her iki özelliği de belirtebilirsinizDepth. Her ikisini de belirterek hafif bir performans kazancı elde edilir.

Bağlama ölçütleri oluşturulduktan sonra, bir değere bağlanabilen bir TreeNode nesnenin özelliğini bağlayabilirsiniz. Bir veri öğesinin alanına veya statik bir değere bağlayabilirsiniz. Statik bir değere bağlanıldığında, nesnenin TreeNodeBinding uygulandığı tüm TreeNode nesneler aynı değeri paylaşır.

Bu özelliğin değeri görünüm durumunda depolanır.

Şunlara uygulanır

Ayrıca bkz.