MenuItem.Value Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines nicht angezeigten Werts, der zum Speichern zusätzlicher Daten zum Menüelement verwendet wird, z. B. Daten zum Behandeln von Postbackereignissen.
public:
property System::String ^ Value { System::String ^ get(); void set(System::String ^ value); };public string Value { get; set; }member this.Value : string with get, setPublic Property Value As StringEigenschaftswert
Ergänzende Daten zu dem nicht angezeigten Menüelement. Der Standardwert ist eine leere Zeichenfolge ("").
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie das Value Menüelement und das übergeordnete Element angezeigt werden, wenn der Benutzer ein Menüelement auswählt.
<%@ 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>
Hinweise
Die Value Eigenschaft wird verwendet, um die Text Eigenschaft zu ergänzen, indem zusätzliche Daten gespeichert werden, die dem Menüelement zugeordnet sind. Dieser Wert wird nicht im Steuerelement angezeigt und wird häufig zum Speichern von Daten für die Behandlung von Postbackereignissen verwendet.
Hinweis
Wenn die Value Eigenschaft enthält null, gibt der get Accessor den Wert der Text Eigenschaft zurück. Wenn die Text Eigenschaft wiederum enthält null, Empty wird diese 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 Trennzeichen getrennte Liste von Menüelementwerten, die einen Pfad vom Stammmenüelement zum aktuellen Menüelement bilden. Der Wertpfad wird verwendet, um die Position eines Menüelements in einem Menu Steuerelement anzugeben.
Hinweis
Menüelemente auf derselben Menüebene müssen jeweils einen eindeutigen Wert für die Value Eigenschaft aufweisen. Das Menu Steuerelement kann nicht zwischen verschiedenen Menüelementen auf derselben Ebene unterscheiden, die denselben Wert aufweist.
Der Wert dieser Eigenschaft kann automatisch mithilfe eines Designertools in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute"Globalisierung und Lokalisierung".
