Sdílet prostřednictvím


TreeNodeBinding.Value Vlastnost

Definice

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

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 se nezobrazují. 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 ukládání doplňkový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 použit. Aby tento příklad fungoval správně, musíte zkopírovat ukázková data XML zadanou po tomto příkladu 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

Při vazbě TreeView ovládacího prvku ke zdroji dat použijte Value vlastnost k určení hodnoty, která se má svázat s Value vlastností objektu TreeNode . Tato relace vazby ovlivňuje všechny TreeNode objekty, na které TreeNodeBinding je objekt použit. Vlastnost Value slouží 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í vazby Value stejné hodnoty na každý uzel můžete vytvořit vazbu Value vlastnosti TreeNode objektu s polem zdroje dat nastavením ValueField vlastnosti.

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

Hodnotu této vlastnosti lze při nastavení automaticky uložit do souboru prostředků pomocí nástroje návrháře. Další informace naleznete v tématu LocalizableAttribute a globalizace a lokalizace.

Platí pro

Viz také