MenuItem.Value Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает неотображаемое значение, используемое для хранения любых дополнительных данных о пункте меню, например, данных, используемых для обработки событий обратной передачи.
public:
property System::String ^ Value { System::String ^ get(); void set(System::String ^ value); };public string Value { get; set; }member this.Value : string with get, setPublic Property Value As StringЗначение свойства
Дополнительная информация о неотображаемом пункте меню. Значение по умолчанию — пустая строка.
Примеры
В следующем примере показано, как отобразить Value для элемента меню и его родительского элемента, когда пользователь выбирает элемент меню.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void NavigationMenu_MenuItemClick(Object sender, MenuEventArgs e)
{
// Display the selected menu item.
if (e.Item.Parent != null)
{
Message.Text = "You selected " + e.Item.Value +
" from " + e.Item.Parent.Value + ".";
}
else
{
Message.Text = "You selected " + e.Item.Value + ".";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItem Value Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItem Value Example</h3>
Select an item from the menu:<br/><br/>
<asp:menu id="NavigationMenu"
staticdisplaylevels="1"
staticsubmenuindent="10"
orientation="Vertical"
onmenuitemclick="NavigationMenu_MenuItemClick"
runat="server">
<dynamicselectedstyle backcolor="yellow"/>
<staticselectedstyle backcolor="yellow"/>
<items>
<asp:menuitem text="Home"
tooltip="Home">
<asp:menuitem text="Category"
value="Category 1"
tooltip="Category 1">
<asp:menuitem text="Topic"
value="Topic 1"
tooltip="Topic 1"/>
<asp:menuitem text="Topic"
value="Topic 2"
tooltip="Topic 2"/>
<asp:menuitem text="Topic"
value="Topic 3"
tooltip="Topic 3"/>
</asp:menuitem>
<asp:menuitem text="Category"
value="Category 2"
tooltip="Category 2">
<asp:menuitem text="Topic"
value="Topic 1"
tooltip="Topic 1"/>
<asp:menuitem text="Topic"
value="Topic 2"
tooltip="Topic 2"/>
<asp:menuitem text="Topic"
value="Topic 3"
tooltip="Topic 3"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
<hr/>
<asp:label id="Message"
runat="server"/>
</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">
<script runat="server">
Sub NavigationMenu_MenuItemClick(ByVal sender As Object, ByVal e As MenuEventArgs)
' Display the selected menu item.
If e.Item.Parent IsNot Nothing Then
Message.Text = "You selected " & e.Item.Value & _
" from " & e.Item.Parent.Value & "."
Else
Message.Text = "You selected " & e.Item.Value & "."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItem Value Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItem Value Example</h3>
Select an item from the menu:<br/><br/>
<asp:menu id="NavigationMenu"
staticdisplaylevels="1"
staticsubmenuindent="10"
orientation="Vertical"
onmenuitemclick="NavigationMenu_MenuItemClick"
runat="server">
<dynamicselectedstyle backcolor="yellow"/>
<staticselectedstyle backcolor="yellow"/>
<items>
<asp:menuitem text="Home"
tooltip="Home">
<asp:menuitem text="Category"
value="Category 1"
tooltip="Category 1">
<asp:menuitem text="Topic"
value="Topic 1"
tooltip="Topic 1"/>
<asp:menuitem text="Topic"
value="Topic 2"
tooltip="Topic 2"/>
<asp:menuitem text="Topic"
value="Topic 3"
tooltip="Topic 3"/>
</asp:menuitem>
<asp:menuitem text="Category"
value="Category 2"
tooltip="Category 2">
<asp:menuitem text="Topic"
value="Topic 1"
tooltip="Topic 1"/>
<asp:menuitem text="Topic"
value="Topic 2"
tooltip="Topic 2"/>
<asp:menuitem text="Topic"
value="Topic 3"
tooltip="Topic 3"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
<hr/>
<asp:label id="Message"
runat="server"/>
</form>
</body>
</html>
Комментарии
Свойство Value используется для дополнения Text свойства путем хранения любых дополнительных данных, связанных с элементом меню. Это значение не отображается в элементе управления и обычно используется для хранения данных для обработки событий обратной передачи.
Примечание
Value Если свойство содержит null, get метод доступа возвращает значение Text свойства .
Text Если свойство, в свою очередь, содержит null, Empty возвращается .
Значение Value свойства также используется при создании пути к значению, указанного ValuePath в свойстве . Путь к значению — это разделенный разделителями список значений элементов меню, который формирует путь от корневого пункта меню к текущему элементу меню. Путь к значению используется для указания положения пункта меню в элементе Menu управления .
Примечание
Элементы меню на одном уровне меню должны иметь уникальные значения для Value свойства. Menu Элемент управления не может различать различные элементы меню на одном уровне с одинаковым значением.
Значение этого свойства, если оно задано, можно автоматически сохранить в файл ресурсов с помощью средства конструктора. Дополнительные сведения см. в разделах LocalizableAttributeи Глобализация и локализация.
