System.Web.UI.WebControls.MenuItem.Value Property

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

Syntax

[System.ComponentModel.DefaultValue("")]
[System.ComponentModel.Localizable(true)]
public string Value { set; get; }

Value

Documentation for this section has not yet been entered.

Remarks

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

Note:

If the MenuItem.Value property contains null, the get accessor returns the value of the MenuItem.Text property. If the MenuItem.Text property, in turn, contains null, string.Empty is returned.

The value of the MenuItem.Value property is also used when the value path specified in the MenuItem.ValuePath property is generated. A value path is a delimiter-separated list of menu item values that forms a path from the root menu item to the current menu item. The value path is used to indicate the position of a menu item in a System.Web.UI.WebControls.Menu control.

Note:

Menu items at the same menu level must each have a unique value for the MenuItem.Value property; the System.Web.UI.WebControls.Menu control cannot distinguish between different menu items at the same level that have the same value.

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

Requirements

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0