MenuEventArgs Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece dados para os eventos MenuItemClick e MenuItemDataBound de um controle Menu. Essa 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 a seguir demonstra como usar o MenuEventArgs objeto passado para o manipulador de eventos do MenuItemDataBound evento para modificar as propriedades de um item de menu antes que ele seja exibido em um Menu controle . A ImageUrl propriedade do Home item de menu é definida para exibir apenas uma imagem nesse item de menu. Para que este exemplo funcione corretamente, você deve copiar os dados de mapa do site de exemplo abaixo para um arquivo 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>

Veja a seguir dados de mapa de site de exemplo 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>

</siteMap>

Comentários

A MenuEventArgs classe é usada para armazenar os dados de evento passados para um manipulador de eventos para os eventos na tabela a seguir.

Evento	Descrição
MenuItemClick	Ocorre quando um item de menu é clicado. Esse evento geralmente é usado para sincronizar um Menu controle com outro controle na página.
MenuItemDataBound	Ocorre quando um item de menu está associado aos dados. Esse evento geralmente é usado para modificar um item de menu antes de ser renderizado em um Menu controle .

Dependendo do evento gerado, você pode acessar o item de menu clicado pelo usuário ou o item de menu associado aos dados usando a Item propriedade .

Para obter uma lista de valores de propriedade iniciais para uma instância da MenuEventArgs classe , consulte o MenuEventArgs construtor .

Construtores

MenuEventArgs(MenuItem)	Inicializa uma nova instância da classe MenuEventArgs usando o item de menu especificado.
MenuEventArgs(MenuItem, Object, CommandEventArgs)	Inicializa uma nova instância da classe MenuEventArgs usando os argumentos de evento, origem de comando e item de menu especificados.

Propriedades

CommandArgument	Obtém o argumento para o comando. (Herdado de CommandEventArgs)
CommandName	Obtém o nome do comando. (Herdado de CommandEventArgs)
CommandSource	Obtém o Object que gerou o evento.
Item	Obtém o item de menu associado ao evento gerado.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Partilhar via