(0) exportieren Drucken
Alle erweitern

MenuItem.Value-Eigenschaft

Hinweis: Diese Eigenschaft ist neu in .NET Framework, Version 2.0.

Ruft einen nicht angezeigten Wert ab, mit dem zusätzliche Daten zum Menüelement gespeichert werden (z. B. Daten zum Behandlen eines Postbackereignisses), oder legt diesen Wert fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

[LocalizableAttribute(true)] 
public string Value { get; set; }
/** @property */
public String get_Value ()

/** @property */
public void set_Value (String value)

public function get Value () : String

public function set Value (value : String)

Eigenschaftenwert

Ergänzende Daten zum Menüelement, die nicht angezeigt werden. Der Standardwert ist eine leere Zeichenfolge ("").

Die Value-Eigenschaft wird verwendet, um die Text-Eigenschaft durch das Speichern aller dem Menüelement zusätzlich zugeordneten Daten zu ergänzen. Dieser Wert wird nicht im Steuerelement angezeigt und wird i. d. R. verwendet, um Daten zum Behandeln von Postbackereignissen zu speichern.

HinweisHinweis

Wenn die Value-Eigenschaft NULL (Nothing in Visual Basic) enthält, gibt der get-Accessor den Wert der Text-Eigenschaft zurück. Wenn die Text-Eigenschaft ebenfalls NULL (Nothing in Visual Basic) enthält, wird Empty zurückgegeben.

Der Wert der Value-Eigenschaft wird auch verwendet, wenn der in der ValuePath-Eigenschaft angegebene Wertpfad generiert wird. Ein Wertpfad ist eine durch ein Trennzeichen getrennte Liste mit Menüelementwerten, die einen Pfad vom Stammmenüelement zum aktuellen Menüelement darstellen. Mit dem Wertpfad wird die Position eines Menüelements in einem Menu-Steuerelement angegeben.

HinweisHinweis

Menüelemente auf derselben Menüebene müssen jeweils einen eindeutigen Wert für die Value-Eigenschaft aufweisen. Das Menu-Steuerelement kann nicht zwischen unterschiedlichen Menüelementen unterscheiden, die sich auf derselben Ebene befinden und denselben Wert aufweisen.

Der Wert dieser Eigenschaft (sofern festgelegt) kann mit einem Designertool automatisch in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und unter ASP.NET-Globalisierung und -Lokalisierung.

Im folgenden Codebeispiel wird veranschaulicht, wie bei der Auswahl eines Menüelements durch einen Benutzer der Value für ein Menüelement und dessen übergeordnete Menüelemente angezeigt wird.


<%@ Page Language="C#" %>

<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>
  <body>
    <form 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 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Anzeigen:
© 2014 Microsoft