Partager via

MenuEventArgs Classe

Définition

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

Fournit des données pour les événements et MenuItemClick les MenuItemDataBound événements d’un Menu contrôle. 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 que l’événement MenuItemDataBound modifie 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 carte de site ci-dessous dans un fichier nommé Web.plan.


<%@ 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 un exemple de données de carte 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 transmises à un gestionnaire d’événements pour les événements du tableau suivant.

Événement Description
MenuItemClick Se produit lorsqu’un élément de menu est cliqué. Cet événement est couramment utilisé pour synchroniser un Menu contrôle avec un autre contrôle sur la page.
MenuItemDataBound Se produit lorsqu’un élément de menu est lié aux 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.

Selon 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 MenuEventArgs classe, consultez le MenuEventArgs constructeur.

Constructeurs

Nom Description
MenuEventArgs(MenuItem, Object, CommandEventArgs)

Initialise une nouvelle instance de la MenuEventArgs classe à l’aide de l’élément de menu, de la source de commande et des arguments d’événement spécifiés.
MenuEventArgs(MenuItem)

Initialise une nouvelle instance de la MenuEventArgs classe à l’aide de l’élément de menu spécifié.

Propriétés

Nom Description
CommandArgument

Obtient l’argument de la commande.

(Hérité de CommandEventArgs)
CommandName

Obtient le nom de la commande.

(Hérité de CommandEventArgs)
CommandSource

Obtient l’événement Object déclenché.
Item

Obtient l’élément de menu associé à l’événement déclenché.

Méthodes

Nom Description
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

S’applique à

Voir aussi