MenuEventArgs Класс

Определение

Предоставляет данные для событий MenuItemClick и MenuItemDataBound элемента управления Menu.Provides data for the MenuItemClick and MenuItemDataBound events of a Menu control. Этот класс не наследуется.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
Наследование

Примеры

В следующем примере кода показано, как использовать объект MenuEventArgs , передаваемый обработчику событий MenuItemDataBound для события, чтобы изменить свойства элемента меню перед Menu его отображением в элементе управления.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. ImageUrl СвойствоHome элемента меню настроено для вывода изображения только в этом пункте меню.The ImageUrl property of the Home menu item is set to display an image in that menu item only. Для правильной работы этого примера необходимо скопировать приведенные ниже данные карты сайта в файл с именем 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>

Ниже приведен пример данных схемы сайта для предыдущего примера.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>

Комментарии

MenuEventArgs Класс используется для хранения данных событий, передаваемых обработчику событий для событий, перечисленных в следующей таблице.The MenuEventArgs class is used to store the event data passed to an event handler for the events in the following table.

событиеEvent ОписаниеDescription
MenuItemClick Происходит при щелчке пункта меню.Occurs when a menu item is clicked. Это событие обычно используется для синхронизации Menu элемента управления с другим элементом управления на странице.This event is commonly used to synchronize a Menu control with another control on the page.
MenuItemDataBound Происходит при привязке элемента меню к данным.Occurs when a menu item is bound to data. Это событие обычно используется для изменения пункта меню перед его отрисовкой в Menu элементе управления.This event is commonly used to modify a menu item before it is rendered in a Menu control.

В зависимости от вызванного события можно получить доступ к пункту меню, выбранному пользователем, или элемент меню, привязанный к данным, с помощью Item свойства.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.

Список начальных значений свойств для экземпляра класса MenuEventArgs см. в описании конструктора MenuEventArgs.For a list of initial property values for an instance of the MenuEventArgs class, see the MenuEventArgs constructor.

Конструкторы

MenuEventArgs(MenuItem)

Инициализирует новый экземпляр класса MenuEventArgs с помощью указанного пункта меню.Initializes a new instance of the MenuEventArgs class using the specified menu item.

MenuEventArgs(MenuItem, Object, CommandEventArgs)

Инициализирует новый экземпляр класса MenuEventArgs с использованием указанного пункта меню, источника команд и аргументов события.Initializes a new instance of the MenuEventArgs class using the specified menu item, command source, and event arguments.

Свойства

CommandArgument

Получает аргумент для команды.Gets the argument for the command.

(Унаследовано от CommandEventArgs)
CommandName

Получает имя команды.Gets the name of the command.

(Унаследовано от CommandEventArgs)
CommandSource

Возвращает объект Object, вызвавший появление события.Gets the Object that raised the event.

Item

Возвращает пункт меню, связанный с вызванным событием.Gets the menu item associated with the event raised.

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

Дополнительно