Sdílet prostřednictvím


TreeNodeBinding.Value Vlastnost

Definice

Získá nebo nastaví zobrazenou hodnotu, která není zobrazena, ale slouží k uložení všech dalších dat o uzlu, na který TreeNodeBinding je objekt použit, například data používaná pro zpracování postback událostí.

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

Hodnota vlastnosti

Doplňující data o uzlu, na který TreeNodeBinding je objekt použit; tato data nejsou zobrazena. Výchozí hodnota je prázdný řetězec ("").

Příklady

Tato část obsahuje dva příklady kódu. První příklad kódu ukazuje, jak použít Value vlastnost k uložení doplňujících dat o uzlu, na který TreeNodeBinding je objekt použit. Druhý příklad kódu poskytuje ukázková data XML pro první příklad kódu.

Následující příklad ukazuje, jak použít Value vlastnost k uložení doplňujících dat o uzlu, na který TreeNodeBinding je objekt aplikován. Aby tento příklad fungoval správně, musíte zkopírovat ukázková data XML za tímto příkladem kódu do souboru s názvem Booklist.xml.


<%@ 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 Text, ImageUrl, ImageToolTip, -->
      <!-- NavigateUrl, Value, and ToolTip       -->
      <!-- 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" 
            Text="Book Title" 
            ImageUrl="Image.jpg"
            ImageToolTip="Book Image" 
            NavigateUrl="http://www.microsoft.com" 
            Value="BookID" 
            ToolTip="Book Information"/>
          <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 Text, ImageUrl, ImageToolTip, -->
      <!-- NavigateUrl, Value, and ToolTip       -->
      <!-- 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" 
            Text="Book Title" 
            ImageUrl="Image.jpg"
            ImageToolTip="Book Image" 
            NavigateUrl="http://www.microsoft.com" 
            Value="BookID" 
            ToolTip="Book Information"/>
          <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>

Následující příklad kódu poskytuje ukázková data XML pro předchozí příklad kódu.

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

Poznámky

TreeView Pokud je ovládací prvek vázán na zdroj dat, pomocí Value vlastnosti určete hodnotu, která se má svázat s Value vlastností objektuTreeNode. Tento vztah vazby má vliv na všechny TreeNode objekty, na které TreeNodeBinding je objekt použit. Vlastnost Value se používá k doplnění Text vlastnosti uložením všech dalších dat přidružených k uzlu, na který TreeNodeBinding je objekt použit. Tato hodnota se v ovládacím prvku nezobrazuje a běžně se používá k ukládání dat pro zpracování událostí postback.

Poznámka

Vlastnost můžete selektivně přepsat Value nastavením Value vlastnosti každého uzlu přímo.

Místo použití vlastnosti k vytvoření Value vazby stejné hodnoty s každým uzlem můžete Value vlastnost objektu TreeNode svázat s polem zdroje dat nastavením ValueField vlastnosti.

Hodnota této vlastnosti je uložena ve stavu zobrazení.

Hodnota této vlastnosti, pokud je nastavená, se dá automaticky uložit do souboru prostředků pomocí nástroje návrháře. Další informace najdete v tématech LocalizableAttributeGlobalizace a lokalizace.

Platí pro

Viz také