MenuEventArgs Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des données pour les événements MenuItemClick et MenuItemDataBound d'un contrôle Menu. Cette classe ne peut pas être héritée.
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- Héritage
Exemples
L’exemple de code suivant montre comment utiliser l’objet MenuEventArgs passé au gestionnaire d’événements pour l’événement MenuItemDataBound afin de modifier les propriétés d’un élément de menu avant qu’il ne soit affiché dans un Menu contrôle. La ImageUrl propriété de l’élément Home de menu est définie pour afficher une image dans cet élément de menu uniquement. Pour que cet exemple fonctionne correctement, vous devez copier l’exemple de données de plan de site ci-dessous dans un fichier nommé 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>
Voici des exemples de données de plan de site pour l’exemple précédent.
<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>
Remarques
La MenuEventArgs classe est utilisée pour stocker les données d’événement passées à un gestionnaire d’événements pour les événements dans le tableau suivant.
| Événement | Description |
|---|---|
| MenuItemClick | Se produit lorsque vous cliquez sur un élément de menu. Cet événement est couramment utilisé pour synchroniser un Menu contrôle avec un autre contrôle de la page. |
| MenuItemDataBound | Se produit lorsqu’un élément de menu est lié à des données. Cet événement est couramment utilisé pour modifier un élément de menu avant qu’il ne soit rendu dans un Menu contrôle. |
En fonction de l’événement déclenché, vous pouvez accéder à l’élément de menu cliqué par l’utilisateur ou à l’élément de menu lié aux données à l’aide de la Item propriété .
Pour obtenir la liste des valeurs de propriété initiales d'une instance de la classe MenuEventArgs, consultez le constructeur MenuEventArgs.
Constructeurs
| MenuEventArgs(MenuItem) |
Initialise une nouvelle instance de la classe MenuEventArgs à l'aide de l'élément de menu spécifié. |
| MenuEventArgs(MenuItem, Object, CommandEventArgs) |
Initialise une nouvelle instance de la classe MenuEventArgs à l'aide de l'élément de menu, de la source de commande et des arguments d'événement spécifiés. |
Propriétés
| CommandArgument |
Obtient l'argument de la commande. (Hérité de CommandEventArgs) |
| CommandName |
Obtient le nom de la commande. (Hérité de CommandEventArgs) |
| CommandSource |
Obtient le Object qui a déclenché l'événement. |
| Item |
Obtient l'élément de menu associé à l'événement déclenché. |
Méthodes
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
