MenuEventArgs Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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::CommandEventArgspublic sealed class MenuEventArgs : System.Web.UI.WebControls.CommandEventArgstype MenuEventArgs = class
inherit CommandEventArgsPublic NotInheritable Class MenuEventArgs
Inherits CommandEventArgs- Ereditarietà
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) |
