MenuEventArgs Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Fornisce i dati per gli eventi MenuItemClick e MenuItemDataBound di un controllo Menu. La classe non può essere ereditata.

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
Ereditarietà
Object
EventArgs
CommandEventArgs
MenuEventArgs

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare l'oggetto MenuEventArgs passato al gestore eventi per l'evento MenuItemDataBound per modificare le proprietà di una voce di menu prima che venga visualizzata in un Menu controllo . La ImageUrl proprietà della Home voce di menu è impostata per visualizzare un'immagine solo in tale voce di menu. Per il corretto funzionamento di questo esempio, è necessario copiare i dati della mappa del sito di esempio riportati di seguito in un file denominato 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>

Di seguito sono riportati i dati della mappa del sito di esempio per l'esempio precedente.

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

Commenti

La MenuEventArgs classe viene usata per archiviare i dati dell'evento passati a un gestore eventi per gli eventi nella tabella seguente.

Event Descrizione
MenuItemClick Si verifica quando si fa clic su una voce di menu. Questo evento viene comunemente usato per sincronizzare un Menu controllo con un altro controllo nella pagina.
MenuItemDataBound Si verifica quando una voce di menu è associata ai dati. Questo evento viene comunemente usato per modificare una voce di menu prima che venga eseguito il rendering in un Menu controllo .

A seconda dell'evento generato, è possibile accedere alla voce di menu selezionata dall'utente o dalla voce di menu associata ai dati usando la Item proprietà .

Per un elenco dei valori iniziali delle proprietà di un'istanza della classe MenuEventArgs, vedere il costruttore MenuEventArgs.

Costruttori

MenuEventArgs(MenuItem)

Inizializza una nuova istanza della classe MenuEventArgs utilizzando la voce di menu specificata.
MenuEventArgs(MenuItem, Object, CommandEventArgs)

Inizializza una nuova istanza della classe MenuEventArgs utilizzando la voce di menu, l'origine del comando e gli argomenti dell'evento specificati.

Proprietà

CommandArgument

Ottiene l'argomento del comando.

(Ereditato da CommandEventArgs)
CommandName

Ottiene il nome del comando.

(Ereditato da CommandEventArgs)
CommandSource

Ottiene la classe Object che ha generato l'evento.
Item

Ottiene la voce di menu associata all'evento generato.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche