MenuEventArgs Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt gegevens voor de MenuItemClick en MenuItemDataBound gebeurtenissen van een Menu besturingselement. Deze klasse kan niet worden overgenomen.
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- Overname
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u het MenuEventArgs object gebruikt dat is doorgegeven aan de gebeurtenishandler om MenuItemDataBound de eigenschappen van een menu-item te wijzigen voordat het in een Menu besturingselement wordt weergegeven. De ImageUrl eigenschap van het Home menu-item is ingesteld om alleen een afbeelding in dat menu-item weer te geven. Als dit voorbeeld correct werkt, moet u de onderstaande voorbeeldsiteoverzichtgegevens kopiëren naar een bestand met de naam Web.sitemap.
<%@ 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>
Hier volgt een voorbeeld van siteoverzichtsgegevens voor het vorige voorbeeld.
<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>
Opmerkingen
De MenuEventArgs klasse wordt gebruikt om de gebeurtenisgegevens op te slaan die worden doorgegeven aan een gebeurtenis-handler voor de gebeurtenissen in de volgende tabel.
| Gebeurtenis | Description |
|---|---|
| MenuItemClick | Treedt op wanneer op een menu-item wordt geklikt. Deze gebeurtenis wordt vaak gebruikt om een Menu besturingselement te synchroniseren met een ander besturingselement op de pagina. |
| MenuItemDataBound | Treedt op wanneer een menu-item is gebonden aan gegevens. Deze gebeurtenis wordt vaak gebruikt om een menu-item te wijzigen voordat deze in een Menu besturingselement wordt weergegeven. |
Afhankelijk van de gebeurtenis die is gegenereerd, hebt u toegang tot het menu-item waarop de gebruiker heeft geklikt of het menu-item dat is gebonden aan gegevens met behulp van de Item eigenschap.
Zie de MenuEventArgs constructor voor een lijst met initiële eigenschapswaarden voor een exemplaar van de MenuEventArgs klasse.
Constructors
| Name | Description |
|---|---|
| MenuEventArgs(MenuItem, Object, CommandEventArgs) |
Initialiseert een nieuw exemplaar van de MenuEventArgs klasse met behulp van het opgegeven menu-item, de opdrachtbron en gebeurtenisargumenten. |
| MenuEventArgs(MenuItem) |
Initialiseert een nieuw exemplaar van de MenuEventArgs klasse met behulp van het opgegeven menu-item. |
Eigenschappen
| Name | Description |
|---|---|
| CommandArgument |
Hiermee haalt u het argument voor de opdracht op. (Overgenomen van CommandEventArgs) |
| CommandName |
Hiermee haalt u de naam van de opdracht op. (Overgenomen van CommandEventArgs) |
| CommandSource |
Hiermee haalt u de Object gebeurtenis op. |
| Item |
Hiermee wordt het menu-item opgehaald dat is gekoppeld aan de gebeurtenis die is gegenereerd. |
Methoden
| Name | Description |
|---|---|
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |