MenuItem.Selected 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.
Ruft einen Wert ab, der angibt, ob das aktuelle Menüelement in einem Menu-Steuerelement ausgewählt ist, oder legt diesen Wert fest.
public:
property bool Selected { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(true)]
public bool Selected { get; set; }
[<System.ComponentModel.Browsable(true)>]
member this.Selected : bool with get, set
Public Property Selected As Boolean
Eigenschaftswert
true
, um anzugeben, dass das aktuelle Menüelement in einem Menu-Steuerelement ausgewählt ist, andernfalls false
. Der Standardwert ist false
.
- Attribute
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie die Eigenschaft verwenden, um ein bestimmtes Menüelement in einem Menu Steuerelement auszuwählen, wenn die Selected Seite zuerst geladen wird. In diesem Beispiel müssen Sie die Beispielwebsitezuordnungsdaten unten in eine Datei mit dem Namen Web.sitemap kopieren.
<%@ 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_MenuItemDataBound(Object sender, MenuEventArgs e)
{
// Get the menu item being bound to data.
MenuItem item = e.Item;
// Use the Selected property to select the Home
// menu item when the page is first loaded.
if (item.Text == "Home")
{
item.Selected = true;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItem Selected Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItem Selected Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
datasourceid="MenuSource"
onmenuitemdatabound="NavigationMenu_MenuItemDataBound"
runat="server">
<staticselectedstyle backcolor="Yellow"/>
</asp:menu>
<asp:sitemapdatasource id="MenuSource"
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_MenuItemDataBound(ByVal sender As Object, ByVal e As MenuEventArgs)
' Get the menu item being bound to data.
Dim item As MenuItem = e.Item
' Use the Selected property to select the Home
' menu item when the page is first loaded.
If item.Text = "Home" Then
item.Selected = True
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItem Selected Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItem Selected Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
datasourceid="MenuSource"
onmenuitemdatabound="NavigationMenu_MenuItemDataBound"
runat="server">
<staticselectedstyle backcolor="Yellow"/>
</asp:menu>
<asp:sitemapdatasource id="MenuSource"
runat="server"/>
</form>
</body>
</html>
Das folgende Beispiel ist Beispielwebsitezuordnungsdaten für das vorherige Beispiel.
<siteMap>
<siteMapNode url="~\Home.aspx"
title="Home"
description="Home">
<siteMapNode url="~\Music.aspx"
title="Music"
description="Music">
<siteMapNode url="~\Classical.aspx"
title="Classical"
description="Classical"/>
<siteMapNode url="~\Rock.aspx"
title="Rock"
description="Rock"/>
<siteMapNode url="~\Jazz.aspx"
title="Jazz"
description="Jazz"/>
</siteMapNode>
<siteMapNode url="~\Movies.aspx"
title="Movies"
description="Movies">
<siteMapNode url="~\Action.aspx"
title="Action"
description="Action"/>
<siteMapNode url="~\Drama.aspx"
title="Drama"
description="Drama"/>
<siteMapNode url="~\Musical.aspx"
title="Musical"
description="Musical"/>
</siteMapNode>
</siteMapNode>
</siteMap>
Hinweise
Verwenden Sie die Eigenschaft, um anzugeben oder zu bestimmen, ob das Selected aktuelle Menüelement ausgewählt ist.
Hinweis
Obwohl die Eigenschaft verwendet werden kann, um festzustellen, ob ein Menüelement ausgewählt ist, ist es häufiger, die SelectedItem Eigenschaft zu verwenden.
Nur ein Menüelement kann gleichzeitig im Menu Steuerelement ausgewählt werden.