MenuEventArgs Classe

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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::CommandEventArgs
public sealed class MenuEventArgs : System.Web.UI.WebControls.CommandEventArgs
type MenuEventArgs = class
    inherit CommandEventArgs
Public NotInheritable Class MenuEventArgs
Inherits CommandEventArgs
Héritage
Object
EventArgs
CommandEventArgs
MenuEventArgs

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)

S’applique à

Voir aussi