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 Value utilizar la propiedad para especificar un valor no mostrado asociado a 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 usa en cada elemento de menú al que MenuItemBinding se aplica el objeto.This value is used in each menu item to which the MenuItemBinding object is applied. Para que 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 un ejemplo de datos del mapa del sitio 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 está enlazado a un origen de datos, Value utilice la propiedad para especificar el valor que se MenuItem.Value va a enlazar a la 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ú a MenuItemBinding los que 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 utiliza para almacenar datos adicionales sobre un elemento de menú al que 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ú individual 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 Value la propiedad de MenuItem un objeto a un campo de un origen de datos estableciendo ValueField la 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 representa, la Value propiedad de cada elemento de menú al que MenuItemBinding se aplica el objeto contiene el valor correspondiente del campo.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 se Value establecen ValueField las propiedades y, 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 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: