MenuItemBinding.Value MenuItemBinding.Value MenuItemBinding.Value MenuItemBinding.Value Property

Definición

Obtiene o establece un valor no mostrado que se utiliza para almacenar datos adicionales sobre un elemento de menú al que se aplica el objeto MenuItemBinding; los datos se pueden utilizar, por ejemplo, para controlar eventos de postback.Gets or sets a nondisplayed value used to store any additional data about a menu item to which the MenuItemBinding object is applied, 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 sobre un elemento de menú al que se aplica el objeto MenuItemBinding; estos datos no se muestran.Supplemental data about a menu item to which the MenuItemBinding is applied; this data is not displayed. El valor predeterminado es una cadena vacía (""), lo que indica que esta propiedad no está establecida.The default value is an empty string (""), which indicates that this property is not set.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el Value propiedad para especificar un valor no mostrado asociado con un elemento de menú.The following code example demonstrates how to use the Value property to specify a nondisplayed value associated with a menu item. Este valor se utiliza en cada elemento de menú al que el MenuItemBinding se aplica el objeto.This value is used in each menu item to which the MenuItemBinding object is applied. Este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo siguientes en un archivo denominado Menu.xml.For this example to work correctly, you must copy the sample XML data below to a file named Menu.xml.


<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <databindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            text="Static Title"
            value="Static Description"
            imageurl="~\Images\StaticImage.jpg"
            tooltip="Static ToolTip"/>
          
        </databindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <databindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            text="Static Title"
            value="Static Description"
            imageurl="~\Images\StaticImage.jpg"
            tooltip="Static ToolTip"/>
          
        </databindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

    </form>
  </body>
</html>

El código siguiente es datos de mapa del sitio de ejemplo para el ejemplo anterior.The following code is sample site map data for the previous example.

<MapHomeNode ImageUrl="~\Images\Home.gif"

Title="Home"

Description="Root Page"

ToolTip="Home Page">

<MapNode ImageUrl="~\Images\Music.gif"

Title="Music"

Description="Music Category"

ToolTip="Music Page">

<MapNode ImageUrl="~\Images\Classical.gif"

Title="Classical"

Description="Classical Section"

ToolTip="Classical Page"/>

<MapNode ImageUrl="~\Images\Rock.gif"

Title="Rock"

Description="Rock Section"

ToolTip="Rock Page"/>

<MapNode ImageUrl="~\Images\Jazz.gif"

Title="Jazz"

Description="Jazz Section"

ToolTip="Jazz Page"/>

</MapNode>

<MapNode ImageUrl="~\Images\Movies.gif"

Title="Movies"

Description="Movies Category"

ToolTip="Movies Page">

<MapNode ImageUrl="~\Images\Action.gif"

Title="Action"

Description="Action Section"

ToolTip="Action Page"/>

<MapNode ImageUrl="~\Images\Drama.gif"

Title="Drama"

Description="Drama Section"

ToolTip="Drama Page"/>

<MapNode ImageUrl="~\Images\Musical.gif"

Title="Musical"

Description="Musical Section"

ToolTip="Musical Page"/>

</MapNode>

</MapHomeNode>

Comentarios

Cuando el Menu control se enlaza a un origen de datos, use el Value propiedad para especificar el valor para enlazar con el MenuItem.Value propiedad de un MenuItem objeto.When the Menu control is bound to a data source, use the Value property to specify the value to bind to the MenuItem.Value property of a MenuItem object. Este valor se comparte con todos los elementos de menú al que el MenuItemBinding se aplica el objeto.This value is shared with all menu items to which the MenuItemBinding object is applied. El valor especificado no se muestra en un elemento de menú y se usa para almacenar datos adicionales sobre un elemento de menú al que el MenuItemBinding se aplica el objeto, como los datos utilizados para controlar los eventos de postback.The specified value is not displayed in a menu item and is used to store any additional data about a menu item to which the MenuItemBinding object is applied, such as data used for handling postback events.

Nota

Puede invalidar el valor de un elemento de menú individuales estableciendo su Value propiedad directamente.You can override the value for an individual menu item by setting its Value property directly.

En lugar de usar esta propiedad para especificar el mismo valor para cada elemento de menú, también puede enlazar el Value propiedad de un MenuItem objeto a un campo de un origen de datos estableciendo el ValueField propiedad.Instead of using this property to specify the same value for each menu item, you can also bind the Value property of a MenuItem object to a field of a data source by setting the ValueField property. Cuando se procesa, el Value propiedad de cada elemento de menú al que el MenuItemBinding se aplica el objeto contiene el valor del campo correspondiente.When rendered, the Value property of each menu item to which the MenuItemBinding object is applied contains the corresponding value from the field.

Nota

Si el Value y ValueField se establecen propiedades, la ValueField propiedad tiene prioridad.If the Value and ValueField properties are both set, the ValueField property takes precedence.

El valor de esta propiedad, cuando se establece, se pueden guardar automáticamente en un archivo de recursos utilizando 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, consulte LocalizableAttribute y globalización y localización.For more information, see LocalizableAttribute and Globalization and Localization.

Se aplica a

Consulte también: