TreeNodeBinding.Value Eigenschaft

Definition

Ruft einen angezeigten Wert ab, der nicht angezeigt wird, mit dem aber zusätzliche Daten zu einem Knoten gespeichert werden, auf den das TreeNodeBinding-Objekt angewendet wird (z. B. Daten zum Behandeln eines Postbackereignisses), oder legt diesen Wert fest.Gets or sets a displayed value that is not displayed but is used to store any additional data about a node to which the TreeNodeBinding object is applied, such as data used for handling postback events.

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

Eigenschaftswert

String

Ergänzende Daten zu einem Knoten, auf den das TreeNodeBinding-Objekt angewendet wird. Diese Daten werden nicht angezeigt.Supplemental data about a node to which the TreeNodeBinding object is applied; this data is not displayed. Der Standardwert ist eine leere Zeichenfolge ("").The default is an empty string ("").

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele.This section contains two code examples. Im ersten Codebeispiel wird veranschaulicht, wie die-Eigenschaft verwendet wird Value , um ergänzende Daten zu einem Knoten zu speichern, auf den das- TreeNodeBinding Objekt angewendet wird.The first code example demonstrates how to use the Value property to store supplemental data about a node to which the TreeNodeBinding object is applied. Im zweiten Codebeispiel werden Beispiel-XML-Daten für das erste Codebeispiel bereitstellt.The second code example provides sample XML data for the first code example.

Im folgenden Beispiel wird veranschaulicht, wie die-Eigenschaft verwendet wird Value , um ergänzende Daten zu einem Knoten zu speichern, auf den das- TreeNodeBinding Objekt angewendet wird.The following example demonstrates how to use the Value property to store supplemental data about a node to which the TreeNodeBinding object is applied. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die Beispiel-XML-Daten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei mit dem Namen Booklist.xml kopieren.For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named 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>

Im folgenden Codebeispiel werden Beispiel-XML-Daten für das vorherige Codebeispiel bereitstellt.The following code example provides sample XML data for the preceding code example.

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

Hinweise

Wenn das TreeView Steuerelement an eine Datenquelle gebunden ist, verwenden Value Sie die-Eigenschaft, um den Wert anzugeben, der an die- Value Eigenschaft eines-Objekts gebunden werden soll TreeNode .When the TreeView control is bound to a data source, use the Value property to specify the value to bind to the Value property of a TreeNode object. Diese Bindungs Beziehung wirkt sich TreeNode auf alle Objekte aus, auf die das- TreeNodeBinding Objekt angewendet wird.This binding relationship affects all TreeNode objects to which the TreeNodeBinding object is applied. Mithilfe der- Value Eigenschaft wird die- Text Eigenschaft ergänzt, indem alle zusätzlichen Daten, die dem Knoten zugeordnet sind, auf den das- TreeNodeBinding Objekt angewendet wird, gespeichert werden.The Value property is used to supplement the Text property by storing any additional data associated with the node to which the TreeNodeBinding object is applied. Dieser Wert wird im-Steuerelement nicht angezeigt und wird häufig zum Speichern von Daten für die Behandlung von Post Back Ereignissen verwendet.This value is not displayed in the control and is commonly used to store data for handling postback events.

Hinweis

Sie können die-Eigenschaft selektiv überschreiben, Value indem Sie die- Value Eigenschaft der einzelnen Knoten direkt festlegen.You can selectively override the Value property by setting the Value property of each node directly.

Anstatt die- Value Eigenschaft zu verwenden, um denselben Wert an jeden Knoten zu binden, können Sie die- Value Eigenschaft eines- TreeNode Objekts an ein Feld einer Datenquelle binden, indem Sie die- ValueField Eigenschaft festlegen.Instead of using the Value property to bind the same value to each node, you can bind the Value property of a TreeNode object to a field of a data source by setting the ValueField property.

Der Wert dieser Eigenschaft wird im Ansichts Zustand gespeichert.The value of this property is stored in view state.

Der Wert dieser Eigenschaft, wenn festgelegt, kann mithilfe eines Designers Tools automatisch zu einer Ressourcendatei gespeichert werden.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Weitere Informationen finden Sie unter LocalizableAttribute und Globalisierung und Lokalisierung.For more information, see LocalizableAttribute and Globalization and Localization.

Gilt für:

Siehe auch