TreeNode.Value Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets a non-displayed value used to store any additional data about the node, such as data used for handling postback events.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

[LocalizableAttribute(true)] 
public:
property String^ Value {
	String^ get ();
	void set (String^ value);
}
/** @property */
public String get_Value ()

/** @property */
public void set_Value (String value)

public function get Value () : String

public function set Value (value : String)

Property Value

Supplemental data about the node that is not displayed. The default value is an empty string ("").

The Value property is used to supplement the Text property by storing any additional data associated with the node. This value is not displayed in the control and is commonly used to store data for handling postback events.

NoteNote

If the Value property contains a null reference (Nothing in Visual Basic), the get accessor returns the value of the Text property. If the Text property, in turn, contains a null reference (Nothing in Visual Basic), Empty is returned.

NoteNote

Nodes at the same level must each have a unique value for the Value property; the TreeView control cannot distinguish between different nodes at the same level that have the same value. In this scenario, if the user clicks a node that has a duplicate value, the node that appears first in the TreeView control is selected.

The value of this property is stored in view state.

The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see LocalizableAttribute and ASP.NET Globalization and Localization.

The following code example demonstrates how to use the Value property to store the key field.

No code example is currently available or this language may not be supported.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show: