MenuEventArgs MenuEventArgs MenuEventArgs MenuEventArgs Class

Definizione

Fornisce i dati per gli eventi MenuItemClick e MenuItemDataBound di un controllo Menu.Provides data for the MenuItemClick and MenuItemDataBound events of a Menu control. Questa classe non può essere ereditata.This class cannot be inherited.

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à

Esempi

Nell'esempio di codice riportato di seguito viene illustrato MenuEventArgs come utilizzare l'oggetto passato al gestore eventi MenuItemDataBound per l'evento per modificare le proprietà di una voce di menu prima che venga Menu visualizzata in un controllo.The following code example demonstrates how to use the MenuEventArgs object passed to the event handler for the MenuItemDataBound event to modify the properties of a menu item before it is displayed in a Menu control. La ImageUrl proprietàHome della voce di menu è impostata in modo da visualizzare un'immagine solo nella voce di menu.The ImageUrl property of the Home menu item is set to display an image in that menu item only. Per il corretto funzionamento di questo esempio, è necessario copiare i dati di esempio della mappa del sito in un file denominato Web. sitemap.For this example to work correctly, you must copy the sample site map data below to a file named 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 di esempio della mappa del sito per l'esempio precedente.The following is sample site map data for the previous example.

<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 utilizzata per archiviare i dati degli eventi passati a un gestore eventi per gli eventi nella tabella seguente.The MenuEventArgs class is used to store the event data passed to an event handler for the events in the following table.

eventEvent DescriptionDescription
MenuItemClick Si verifica quando si fa clic su una voce di menu.Occurs when a menu item is clicked. Questo evento viene comunemente usato per sincronizzare un Menu controllo con un altro controllo nella pagina.This event is commonly used to synchronize a Menu control with another control on the page.
MenuItemDataBound Si verifica quando una voce di menu viene associata ai dati.Occurs when a menu item is bound to data. Questo evento viene comunemente usato per modificare una voce di menu prima di eseguirne il Menu rendering in un controllo.This event is commonly used to modify a menu item before it is rendered in a Menu control.

A seconda dell'evento generato, è possibile accedere alla voce di menu su cui è stato fatto clic dall'utente o alla voce di menu associata ai dati Item utilizzando la proprietà.Depending on the event raised, you can access the menu item clicked by the user or the menu item being bound to data by using the Item property.

Per un elenco dei valori iniziali delle proprietà di un'istanza della classe MenuEventArgs, vedere il costruttore MenuEventArgs.For a list of initial property values for an instance of the MenuEventArgs class, see the MenuEventArgs constructor.

Costruttori

MenuEventArgs(MenuItem) MenuEventArgs(MenuItem) MenuEventArgs(MenuItem) MenuEventArgs(MenuItem)

Inizializza una nuova istanza della classe MenuEventArgs utilizzando la voce di menu specificata.Initializes a new instance of the MenuEventArgs class using the specified menu item.

MenuEventArgs(MenuItem, Object, CommandEventArgs) MenuEventArgs(MenuItem, Object, CommandEventArgs) MenuEventArgs(MenuItem, Object, CommandEventArgs) 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.Initializes a new instance of the MenuEventArgs class using the specified menu item, command source, and event arguments.

Proprietà

CommandArgument CommandArgument CommandArgument CommandArgument

Ottiene l'argomento del comando.Gets the argument for the command.

(Inherited from CommandEventArgs)
CommandName CommandName CommandName CommandName

Ottiene il nome del comando.Gets the name of the command.

(Inherited from CommandEventArgs)
CommandSource CommandSource CommandSource CommandSource

Ottiene la classe Object che ha generato l'evento.Gets the Object that raised the event.

Item Item Item Item

Ottiene la voce di menu associata all'evento generato.Gets the menu item associated with the event raised.

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Si applica a

Vedi anche