MenuEventArgs Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Innehåller data för och händelser för MenuItemClickMenuItemDataBound en Menu kontroll. Det går inte att ärva den här klassen.
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- Arv
Exempel
Följande kodexempel visar hur du använder objektet MenuEventArgs som skickas till händelsehanteraren för händelsen för att ändra egenskaperna för MenuItemDataBound ett menyalternativ innan det visas i en Menu kontroll. Egenskapen ImageUrl för menyalternativet Home är inställd på att endast visa en bild i menyalternativet. För att det här exemplet ska fungera korrekt måste du kopiera exempelwebbplatsens mappningsdata nedan till en fil med namnet 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>
Följande är exempel på webbplatsöversiktsdata för föregående exempel.
<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>
Kommentarer
Klassen MenuEventArgs används för att lagra händelsedata som skickas till en händelsehanterare för händelserna i följande tabell.
| Händelse | Description |
|---|---|
| MenuItemClick | Inträffar när ett menyalternativ klickas. Den här händelsen används ofta för att synkronisera en Menu kontroll med en annan kontroll på sidan. |
| MenuItemDataBound | Inträffar när ett menyalternativ är bundet till data. Den här händelsen används ofta för att ändra ett menyalternativ innan det återges i en Menu kontroll. |
Beroende på vilken händelse som genereras kan du komma åt menyalternativet som klickas av användaren eller menyalternativet som är bundet till data med hjälp Item av egenskapen .
En lista över initiala egenskapsvärden för en instans av MenuEventArgs klassen finns i MenuEventArgs konstruktorn.
Konstruktorer
| Name | Description |
|---|---|
| MenuEventArgs(MenuItem, Object, CommandEventArgs) |
Initierar en ny instans av MenuEventArgs klassen med det angivna menyalternativet, kommandokällan och händelseargumenten. |
| MenuEventArgs(MenuItem) |
Initierar en ny instans av MenuEventArgs klassen med det angivna menyalternativet. |
Egenskaper
| Name | Description |
|---|---|
| CommandArgument |
Hämtar argumentet för kommandot. (Ärvd från CommandEventArgs) |
| CommandName |
Hämtar namnet på kommandot. (Ärvd från CommandEventArgs) |
| CommandSource |
Hämtar den Object som tog upp händelsen. |
| Item |
Hämtar menyalternativet som är associerat med händelsen som har tagits upp. |
Metoder
| Name | Description |
|---|---|
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
