MenuEventArgs Klasse
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.
Stellt Daten für das MenuItemClick-Ereignis und das MenuItemDataBound-Ereignis eines Menu-Steuerelements bereit. Diese Klasse kann nicht vererbt werden.
public ref class MenuEventArgs sealed : System::Web::UI::WebControls::CommandEventArgspublic sealed class MenuEventArgs : System.Web.UI.WebControls.CommandEventArgstype MenuEventArgs = class
inherit CommandEventArgsPublic NotInheritable Class MenuEventArgs
Inherits CommandEventArgs- Vererbung
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie das MenuEventArgs an den Ereignishandler übergebene -Objekt für das MenuItemDataBound Ereignis verwendet wird, um die Eigenschaften eines Menüelements zu ändern, bevor es in einem Menu Steuerelement angezeigt wird. Die ImageUrl -Eigenschaft des Home Menüelements ist so festgelegt, dass nur ein Bild in diesem Menüelement angezeigt wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die unten angegebenen Beispiel-Siteübersichtsdaten in eine Datei namens 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 MenuItemDataBound_NavigationMenu(Object sender, MenuEventArgs e)
{
// Display an image for the Home menu item only by
// setting its ImageUrl property.
if (e.Item.Text == "Home")
{
// Use an @-quoted string to bypass the escape sequence
// processing.
e.Item.ImageUrl = @"Images\Home.jpg";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuEventArgs Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuEventArgs Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
datasourceid="menusource"
onmenuitemdatabound="MenuItemDataBound_NavigationMenu"
runat="server">
</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 MenuItemDataBound_NavigationMenu(ByVal sender As Object, ByVal e As MenuEventArgs)
' Display an image for the Home menu item only by
' setting its ImageUrl property.
If e.Item.Text = "Home" Then
e.Item.ImageUrl = "Images\Home.jpg"
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuEventArgs Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>MenuEventArgs Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
datasourceid="menusource"
onmenuitemdatabound="MenuItemDataBound_NavigationMenu"
runat="server">
</asp:menu>
<asp:SiteMapDataSource id="MenuSource"
Runat="server"/>
</form>
</body>
</html>
Im Folgenden finden Sie Beispiel-Siteübersichtsdaten 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
Die MenuEventArgs -Klasse wird verwendet, um die Ereignisdaten zu speichern, die an einen Ereignishandler für die Ereignisse in der folgenden Tabelle übergeben werden.
| Ereignis | Beschreibung |
|---|---|
| MenuItemClick | Tritt auf, wenn auf ein Menüelement geklickt wird. Dieses Ereignis wird häufig verwendet, um ein Steuerelement mit einem Menu anderen Steuerelement auf der Seite zu synchronisieren. |
| MenuItemDataBound | Tritt auf, wenn ein Menüelement an Daten gebunden ist. Dieses Ereignis wird häufig verwendet, um ein Menüelement zu ändern, bevor es in einem Menu Steuerelement gerendert wird. |
Je nach ausgelöstem Ereignis können Sie mithilfe der -Eigenschaft auf das Menüelement zugreifen, auf das der Benutzer geklickt hat, oder auf das Menüelement, das Item an Daten gebunden ist.
Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz der MenuEventArgs-Klasse finden Sie im MenuEventArgs-Konstruktor.
Konstruktoren
| MenuEventArgs(MenuItem) |
Initialisiert eine neue Instanz der MenuEventArgs-Klasse unter Verwendung des angegebenen Menüelements. |
| MenuEventArgs(MenuItem, Object, CommandEventArgs) |
Initialisiert eine neue Instanz der MenuEventArgs-Klasse unter Verwendung des angegebenen Menüelements, der Befehlsquelle und der Ereignisargumente. |
Eigenschaften
| CommandArgument |
Ruft das Argument für den Befehl ab. (Geerbt von CommandEventArgs) |
| CommandName |
Ruft den Namen des Befehls ab. (Geerbt von CommandEventArgs) |
| CommandSource |
Ruft das Object ab, das das Ereignis ausgelöst hat. |
| Item |
Ruft das Menüelement ab, das dem ausgelösten Ereignis zugeordnet ist. |
Methoden
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
