Exporter (0) Imprimer
Développer tout

MenuEventArgs, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

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.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public sealed class MenuEventArgs : CommandEventArgs
public final class MenuEventArgs extends CommandEventArgs
public final class MenuEventArgs extends CommandEventArgs

La classe MenuEventArgs est utilisée pour stocker les données d'événement passées à un gestionnaire d'événements pour les événements décrits dans le tableau suivant.

Événement

Description

MenuItemClick

Se produit lorsqu'un utilisateur clique sur un élément de menu. Cet événement est utilisé généralement pour synchroniser un contrôle Menu 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 utilisé généralement pour modifier un élément de menu avant qu'il soit restitué dans un contrôle Menu.

Selon l'événement déclenché, vous pouvez accéder à l'élément de menu sur lequel l'utilisateur a cliqué ou à l'élément de menu lié aux données en utilisant la propriété Item.

Pour obtenir la liste des valeurs de propriété initiales d'une instance de la classe MenuEventArgs, consultez le constructeur MenuEventArgs.

L'exemple de code suivant montre comment utiliser l'objet MenuEventArgs passé au gestionnaire d'événements pour l'événement MenuItemDataBound pour modifier les propriétés d'un élément de menu avant qu'il soit affiché dans un contrôle Menu. La propriété ImageUrl de l'élément de menu Home est configurée pour afficher uniquement une image dans cet élément de menu. Pour que cet exemple fonctionne, vous devez copier les données du plan de site ci-dessous dans un fichier nommé Web.sitemap.


<%@ Page Language="C#" %>

<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>
  <body>
    <form 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>


Ceci est un exemple de données de plan de site de 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>

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

System.Object
   System.EventArgs
     System.Web.UI.WebControls.CommandEventArgs
      System.Web.UI.WebControls.MenuEventArgs

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft