Share via


TreeNodeBinding.ValueField Özellik

Tanım

Veri kaynağından nesnenin uygulandığı nesnenin TreeNodeTreeNodeBinding özelliğine Value bağlanacak alanın adını alır veya ayarlar.

public:
 property System::String ^ ValueField { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ValueField { get; set; }
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ValueField { get; set; }
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ValueField : string with get, set
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ValueField : string with get, set
Public Property ValueField As String

Özellik Değeri

Nesnenin uygulandığı nesnenin ValueTreeNode özelliğine bağlanacak TreeNodeBinding alanın adı. Varsayılan, özelliğin ValueField ayarlanmadığını gösteren boş bir dizedir ("").

Öznitelikler

Örnekler

Bu bölüm iki kod örneği içerir. İlk kod örneği, bir XML öğesinin hangi özniteliğinin nesnenin ValueField uygulandığı nesnenin özelliğine Value bağlanacağını belirtmek için TreeNodeBinding özelliğinin TreeNode 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 örnekte, bir XML öğesinin hangi özniteliğinin nesnenin ValueField uygulandığı nesnenin özelliğine bağlanacağını belirtmek için ValueTreeNodeBinding özelliğinin TreeNode nasıl kullanılacağı gösterilmektedir. Bu örneğin doğru çalışması için, bu kod örneğinden sonra sağlanan örnek XML verilerini Booklist.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 Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeViewBinding Example</h3>
    
      <!-- Set the TextField, ImageUrlField, NavigateUrlField, -->
      <!-- ValueField, and ToolTipField properties of a    -->
      <!-- TreeNodeBinding object declaratively.         -->
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        Target="_blank" 
        runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Books" 
            Depth="0" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="1" 
            TextField="Text" 
            ImageUrlField="Image"
            ImageToolTipField="ImageToolTip" 
            NavigateUrlField="Nav" 
            ValueField="Value" 
            ToolTipField="Tip"/>
          <asp:TreeNodeBinding DataMember="Description" 
            Depth="2" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Price" 
            Depth="2" 
            TextField="Value"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Booklist.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 Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeViewBinding Example</h3>
    
      <!-- Set the TextField, ImageUrlField, NavigateUrlField, -->
      <!-- ValueField, and ToolTipField properties of a    -->
      <!-- TreeNodeBinding object declaratively.         -->
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        Target="_blank" 
        runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Books" 
            Depth="0" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="1" 
            TextField="Text" 
            ImageUrlField="Image"
            ImageToolTipField="ImageToolTip" 
            NavigateUrlField="Nav" 
            ValueField="Value" 
            ToolTipField="Tip"/>
          <asp:TreeNodeBinding DataMember="Description" 
            Depth="2" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Price" 
            Depth="2" 
            TextField="Value"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Booklist.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.

<Books Text="Books List">  
    <Book Text="Book Title One"  
        Value="1"   
        Image="Bookimage1.jpg"  
        ImageToolTip="Book 1 Photo"   
        Nav="http://www.microsoft.com"  
        Tip="Book Title 1">  
        <Description Text="Book Description">  
        </Description>  
        <Price Value="$1.99">  
        </Price>  
        <Author Text="Author Name"  
            Value="LastName"   
            Image="Authorimage1.jpg"   
            Nav="http://www.microsoft.com"  
            Tip="Author Name">  
        </Author>  
    </Book>  
    <Book Text="Book Title Two"  
        Value="2"   
        Image="Bookimage2.jpg"  
        ImageToolTip="Book 2 Photo"   
        Nav="http://www.microsoft.com"  
        Tip="Click Me">  
        <Description Text="Book Description">  
        </Description>  
        <Price Value="$2.99">  
        </Price>  
        <Author Text="Author Name"  
            Value="LastName"   
            Image="Authorimage2.jpg"   
            Nav="http://www.microsoft.com"  
            Tip="Author Name">  
        </Author>  
    </Book>  
</Books>  

Açıklamalar

TreeView Denetim bir veri kaynağına bağlı olduğunda, bir nesnenin ValueField özelliğine bağlanacak alan adını belirtmek için Value özelliğini TreeNode kullanın. Bu bağlama ilişkisi, nesnenin TreeNodeBinding uygulandığı tüm TreeNode nesneleri etkiler. Value özelliği, nesnenin Text uygulandığı düğümle ilişkili ek verileri depolayarak özelliği desteklemek için TreeNodeBinding kullanılır. Bu değer denetimde görüntülenmez ve genellikle geri gönderme olaylarını işlemek için verileri depolamak için kullanılır.

Not

Her düğümün ValueField özelliğini doğrudan ayarlayarak Value özelliği seçmeli olarak geçersiz kılabilirsiniz.

bir nesnenin ValueField özelliğini bir TreeNode alana bağlamak Value için özelliğini kullanmak yerine, özelliğini ayarlayarak özelliği sabit bir değere Value ayarlayabilirsinizValue.

Not

Veri kaynağı birden çok alan içeriyorsa, uygun alana bağlanmak için önce veya DataMember özelliğini ya da her iki özelliği de ayarlamanız Depth gerekir.

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

Şunlara uygulanır

Ayrıca bkz.