MenuEventArgs Classe

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Fornece dados para os MenuItemClick eventos MenuItemDataBound e de um Menu controlo. Esta classe não pode ser herdada.

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
Herança
Object
EventArgs
CommandEventArgs
MenuEventArgs

Exemplos

O exemplo de código seguinte demonstra como usar o MenuEventArgs objeto passado ao gestor de eventos para que o MenuItemDataBound evento modifique as propriedades de um item do menu antes de ser apresentado num Menu controlo. A ImageUrl propriedade do Home item do menu está definida para mostrar uma imagem apenas nesse item do menu. Para que este exemplo funcione corretamente, deve copiar os dados do mapa de sites abaixo para um ficheiro chamado 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>

Segue-se um exemplo de dados de mapa de sítios para o exemplo 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>

Observações

A MenuEventArgs classe é usada para armazenar os dados de eventos passados a um gestor de eventos para os eventos na tabela seguinte.

Event Description
MenuItemClick Ocorre quando um item do menu é clicado. Este evento é frequentemente usado para sincronizar um Menu controlo com outro controlo na página.
MenuItemDataBound Ocorre quando um item do menu está associado a dados. Este evento é comumente usado para modificar um item de menu antes de ser renderizado num Menu controlo.

Dependendo do evento levantado, pode aceder ao item do menu clicado pelo utilizador ou ao item do menu atribuído aos dados usando a Item propriedade.

Para uma lista de valores iniciais de propriedades para uma instância da MenuEventArgs classe, veja o MenuEventArgs construtor.

Construtores

Name Description
MenuEventArgs(MenuItem, Object, CommandEventArgs)

Inicializa uma nova instância da MenuEventArgs classe usando o item de menu especificado, a fonte do comando e os argumentos do evento.
MenuEventArgs(MenuItem)

Inicializa uma nova instância da MenuEventArgs classe usando o item do menu especificado.

Propriedades

Name Description
CommandArgument

Percebe o argumento a favor do comando.

(Herdado de CommandEventArgs)
CommandName

Obtém o nome do comando.

(Herdado de CommandEventArgs)
CommandSource

Recebe o Object que levantou o evento.
Item

Aumenta o item do menu associado ao evento.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também