MenuItem.Value MenuItem.Value MenuItem.Value MenuItem.Value Property

Definición

Obtiene o establece un valor que no se muestra en pantalla y que se utiliza para almacenar datos adicionales sobre el elemento de menú, tales como los datos utilizados para controlar los eventos de postback.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.

public:
 property System::String ^ Value { System::String ^ get(); void set(System::String ^ value); };
public string Value { get; set; }
member this.Value : string with get, set
Public Property Value As String

Valor de propiedad

Datos complementarios, no visibles en pantalla, sobre el elemento de menú.Supplemental data about the menu item that is not displayed. El valor predeterminado es una cadena vacía ("").The default value is an empty string ("").

Ejemplos

En el ejemplo siguiente se muestra cómo mostrar Value para un elemento de menú y su elemento primario cuando el usuario selecciona un elemento de menú.The following example demonstrates how to display the Value for a menu item and its parent when the user selects a menu item.


<%@ 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>

Comentarios

La Value propiedad se utiliza para complementar Text la propiedad almacenando los datos adicionales asociados al elemento de menú.The Value property is used to supplement the Text property by storing any additional data associated with the menu item. Este valor no se muestra en el control y se utiliza normalmente para almacenar los datos para controlar los eventos de postback.This value is not displayed in the control and is commonly used to store data for handling postback events.

Nota

Si la Value propiedad contiene null, el get descriptor de acceso devuelve Text el valor de la propiedad.If the Value property contains null, the get accessor returns the value of the Text property. Si la Text propiedad, a su vez, nullcontiene Empty , se devuelve.If the Text property, in turn, contains null, Empty is returned.

El valor de la Value propiedad también se usa cuando se genera la ruta de acceso ValuePath de valor especificada en la propiedad.The value of the Value property is also used when the value path specified in the ValuePath property is generated. Una ruta de acceso de valor es una lista separada por delimitadores de valores de elementos de menú que forman una ruta de acceso desde el elemento de menú raíz hasta el elemento de menú actual.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. La ruta de acceso del valor se usa para indicar la posición de un elemento Menu de menú en un control.The value path is used to indicate the position of a menu item in a Menu control.

Nota

Los elementos de menú que se encuentra en el mismo nivel de menú deben tener Value cada uno un Menu valor único para la propiedad; el control no puede distinguir entre los distintos elementos de menú del mismo nivel que tienen el mismo valor.Menu items at the same menu level must each have a unique value for the Value property; the Menu control cannot distinguish between different menu items at the same level that have the same value.

El valor de esta propiedad, cuando se establece, se puede guardar automáticamente en un archivo de recursos mediante una herramienta de diseñador.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Para obtener más información, LocalizableAttribute vea y globalización y localización.For more information, see LocalizableAttribute and Globalization and Localization.

Se aplica a

Consulte también: