MenuItem.Value Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor não exibido usado para armazenar quaisquer dados adicionais sobre o item de menu, como dados usados para manipular eventos de 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, setPublic Property Value As StringValor da propriedade
Dados suplementares sobre o item de menu que não são exibidos. O valor padrão é uma cadeia de caracteres vazia ("").
Exemplos
O exemplo a seguir demonstra como exibir o Value para um item de menu e seu pai quando o usuário seleciona um item de menu.
<%@ 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>
Comentários
A Value propriedade é usada para complementar a Text propriedade armazenando quaisquer dados adicionais associados ao item de menu. Esse valor não é exibido no controle e geralmente é usado para armazenar dados para manipular eventos de postback.
Observação
Se a Value propriedade contiver null, o get acessador retornará o valor da Text propriedade . Se a Text propriedade, por sua vez, contiver null, Empty será retornado.
O valor da Value propriedade também é usado quando o caminho do valor especificado na ValuePath propriedade é gerado. Um caminho de valor é uma lista separada por delimitadores de valores de item de menu que forma um caminho do item de menu raiz para o item de menu atual. O caminho do valor é usado para indicar a posição de um item de menu em um Menu controle .
Observação
Os itens de menu no mesmo nível de menu devem ter um valor exclusivo para a Value propriedade; o Menu controle não pode distinguir entre itens de menu diferentes no mesmo nível que tenham o mesmo valor.
O valor dessa propriedade, quando definido, pode ser salvo automaticamente em um arquivo de recurso usando uma ferramenta de designer. Para obter mais informações, consulte LocalizableAttributee Globalização e Localização.
