Поделиться через

MenuEventArgs Класс

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Предоставляет данные для MenuItemClick элементов управления и MenuItemDataBound событий Menu . Этот класс не может быть унаследован.

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
Наследование
Object
EventArgs
CommandEventArgs
MenuEventArgs

Примеры

В следующем примере кода показано, как использовать MenuEventArgs объект, переданный обработчику событий для события, MenuItemDataBound чтобы изменить свойства элемента меню перед отображением в элементе Menu управления. Свойство ImageUrlHome элемента меню имеет значение только для отображения изображения в этом элементе меню. Для правильной работы этого примера необходимо скопировать приведенные ниже данные карты сайта в файл с именем 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>

Ниже приведены примеры данных карты сайта для предыдущего примера.

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

Event Описание
MenuItemClick Происходит при щелчке элемента меню. Это событие обычно используется для синхронизации Menu элемента управления с другим элементом управления на странице.
MenuItemDataBound Происходит, когда элемент меню привязан к данным. Это событие обычно используется для изменения элемента меню перед отрисовкой в элементе Menu управления.

В зависимости от вызываемого события можно получить доступ к элементу меню, щелкнув пользователю или элементу меню, привязанным к данным с помощью Item свойства.

Список начальных значений свойств для экземпляра MenuEventArgs класса см. в конструкторе MenuEventArgs .

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

Имя Описание
MenuEventArgs(MenuItem, Object, CommandEventArgs)

Инициализирует новый экземпляр класса с помощью указанного MenuEventArgs пункта меню, источника команд и аргументов событий.
MenuEventArgs(MenuItem)

Инициализирует новый экземпляр класса с помощью указанного MenuEventArgs элемента меню.

Свойства

Имя Описание
CommandArgument

Возвращает аргумент команды.

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

Возвращает имя команды.

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

Возвращает событие Object , вызвавшее событие.
Item

Возвращает элемент меню, связанный с событием, вызванным.

Методы

Имя Описание
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

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

Служит хэш-функцией по умолчанию.

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

Возвращает Type текущего экземпляра.

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

Создает неглубокую копию текущей Object.

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

Возвращает строку, представляющую текущий объект.

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

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

См. также раздел