MenuItemBinding.Value Eigenschaft

Definition

Ruft einen nicht angezeigten Wert ab, mit dem zusätzliche Daten zu einem Menüelement gespeichert werden, für das das MenuItemBinding-Objekt übernommen wird (z. B. Daten zum Behandeln eines Postbackereignisses), oder legt diesen fest.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

Eigenschaftswert

Ergänzende Daten zu einem Menüelement, für das das MenuItemBinding übernommen wird. Diese Daten werden nicht angezeigt.Supplemental data about a menu item to which the MenuItemBinding is applied; this data is not displayed. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass diese Eigenschaft nicht festgelegt ist.The default value is an empty string (""), which indicates that this property is not set.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Value-Eigenschaft verwendet wird, um einen nicht angezeigten Wert anzugeben, der einem Menü Element zugeordnet ist.The following code example demonstrates how to use the Value property to specify a nondisplayed value associated with a menu item. Dieser Wert wird in jedem Menü Element verwendet, auf das das MenuItemBinding Objekt angewendet wird.This value is used in each menu item to which the MenuItemBinding object is applied. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die folgenden XML-Beispiel Daten in eine Datei mit dem Namen "Menu. xml" kopieren.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>

Der folgende Code ist ein Beispiel für Site Übersichts Daten für das vorherige Beispiel.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>

Hinweise

Wenn das Menu-Steuerelement an eine Datenquelle gebunden ist, verwenden Sie die Value-Eigenschaft, um den Wert anzugeben, der an die MenuItem.Value-Eigenschaft eines MenuItem Objekts gebunden werden soll.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. Dieser Wert wird für alle Menü Elemente freigegeben, auf die das MenuItemBinding Objekt angewendet wird.This value is shared with all menu items to which the MenuItemBinding object is applied. Der angegebene Wert wird nicht in einem Menü Element angezeigt und dient zum Speichern zusätzlicher Daten über ein Menü Element, auf das das MenuItemBinding Objekt angewendet wird, z. b. Daten, die für die Behandlung von Post Back Ereignissen verwendet werden.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.

Hinweis

Sie können den Wert für ein einzelnes Menü Element überschreiben, indem Sie dessen Value-Eigenschaft direkt festlegen.You can override the value for an individual menu item by setting its Value property directly.

Anstatt diese Eigenschaft zu verwenden, um den gleichen Wert für jedes Menü Element anzugeben, können Sie die Value-Eigenschaft eines MenuItem Objekts auch durch Festlegen der ValueField-Eigenschaft an ein Feld einer Datenquelle binden.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. Wenn gerendert wird, enthält die Value-Eigenschaft jedes Menü Elements, auf das das MenuItemBinding-Objekt angewendet wird, den entsprechenden Wert aus dem Feld.When rendered, the Value property of each menu item to which the MenuItemBinding object is applied contains the corresponding value from the field.

Hinweis

Wenn die Eigenschaften Value und ValueField festgelegt sind, hat die Eigenschaft ValueField Vorrang.If the Value and ValueField properties are both set, the ValueField property takes precedence.

Der Wert dieser Eigenschaft, wenn festgelegt, kann mithilfe eines Designers Tools automatisch zu einer Ressourcendatei gespeichert werden.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Weitere Informationen finden Sie unter LocalizableAttribute und Globalisierung und Lokalisierung.For more information, see LocalizableAttribute and Globalization and Localization.

Gilt für:

Siehe auch