MenuEventArgs Clase

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Proporciona datos para los eventos MenuItemClick y MenuItemDataBound de un control Menu. Esta clase no puede heredarse.

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

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el MenuEventArgs objeto pasado al controlador de eventos para que el MenuItemDataBound evento modifique las propiedades de un elemento de menú antes de que se muestre en un Menu control. La ImageUrl propiedad del Home elemento de menú se establece para mostrar una imagen solo en ese elemento de menú. Para que este ejemplo funcione correctamente, debes copiar los datos del mapa del sitio de ejemplo debajo en un archivo denominado 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>

A continuación se incluyen datos de mapa de sitio de ejemplo para el ejemplo anterior.

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

Comentarios

La MenuEventArgs clase se usa para almacenar los datos de eventos pasados a un controlador de eventos para los eventos de la tabla siguiente.

Evento Descripción
MenuItemClick Se produce cuando se hace clic en un elemento de menú. Este evento se usa normalmente para sincronizar un Menu control con otro control en la página.
MenuItemDataBound Se produce cuando un elemento de menú está enlazado a los datos. Este evento se usa normalmente para modificar un elemento de menú antes de representarlo en un Menu control .

Dependiendo del evento generado, puede tener acceso al elemento de menú en el que el usuario o el elemento de menú que se enlaza a los datos mediante la Item propiedad .

Para obtener una lista con los valores de propiedad iniciales de una instancia de la clase MenuEventArgs, vea el constructor MenuEventArgs.

Constructores

MenuEventArgs(MenuItem)

Inicializa una nueva instancia de la clase MenuEventArgs utilizando el elemento de menú especificado.
MenuEventArgs(MenuItem, Object, CommandEventArgs)

Inicializa una nueva instancia de la clase MenuEventArgs utilizando el elemento de menú, el origen de comando y los argumentos de evento especificados.

Propiedades

CommandArgument

Obtiene el argumento del comando.

(Heredado de CommandEventArgs)
CommandName

Obtiene el nombre del comando.

(Heredado de CommandEventArgs)
CommandSource

Obtiene el Object que provocó el evento.
Item

Obtiene el elemento de menú asociado al evento provocado.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también