MenuItem.Value (Propiedad)
Ensamblado: System.Web (en system.web.dll)
/** @property */ public String get_Value () /** @property */ public void set_Value (String value)
public function get Value () : String public function set Value (value : String)
No aplicable.
Valor de propiedad
Datos complementarios, no visibles en pantalla, sobre el elemento de menú. El valor predeterminado es una cadena vacía ("").La propiedad Value se utiliza para complementar la propiedad Text almacenando cualquier información adicional asociada al elemento de menú. Este valor no se muestra en el control, y se suele utilizar con el fin de almacenar información para controlar eventos de devolución de datos.
 Nota: |
|---|
| Si la propiedad Value contiene referencia null (Nothing en Visual Basic), el descriptor de acceso get devuelve el valor de la propiedad Text. Si, a su vez, la propiedad Text contiene referencia null (Nothing en Visual Basic), se devuelve Empty. |
El valor de la propiedad Value también se utiliza al generar la ruta de acceso del valor especificada en la propiedad ValuePath. Una ruta de acceso de un valor es una lista de valores de elementos de menú, separados por delimitadores, que forma una ruta de acceso desde el elemento de menú raíz al elemento de menú actual. La ruta de acceso de valores se utiliza para indicar la posición de un elemento de menú en un control Menu.
| Nota: |
|---|
| Los elementos de menú situados en el mismo nivel de menú deben tener cada uno un valor único para la propiedad Value; el control Menu no puede distinguir entre diferentes elementos de menú del mismo nivel con el mismo valor. |
El valor de esta propiedad, cuando se establece, se puede guardar automáticamente en un archivo de recursos utilizando una herramienta de diseñador. Para obtener más información, vea LocalizableAttribute y Globalización y adaptación en ASP.NET.
El ejemplo de código siguiente muestra cómo visualizar la información de Value para un elemento de menú y su elemento primario cuando el usuario selecciona un elemento de menú.
<%@ 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>
Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter
Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.Referencia
MenuItem (Clase)MenuItem (Miembros)
System.Web.UI.WebControls (Espacio de nombres)
Menu
MenuItem.ImageUrl (Propiedad)
MenuItem.NavigateUrl (Propiedad)
MenuItem.PopOutImageUrl (Propiedad)
MenuItem.SeparatorImageUrl (Propiedad)
MenuItem.Target (Propiedad)
MenuItem.Text (Propiedad)
MenuItem.ToolTip (Propiedad)
