Sdílet prostřednictvím


MenuEventArgs Třída

Definice

Poskytuje data pro MenuItemClick události Menu a MenuItemDataBound ovládacího prvku. Tato třída se nemůže dědit.

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
Dědičnost

Příklady

Následující příklad kódu ukazuje, jak použít MenuEventArgs objekt předaný obslužné rutině události pro MenuItemDataBound událost ke změně vlastností položky nabídky před zobrazením v ovládacím Menu prvku. Vlastnost ImageUrlHome položky nabídky je nastavena tak, aby zobrazovala obrázek pouze v této položce nabídky. Aby tento příklad fungoval správně, musíte zkopírovat ukázková data mapy webu níže do souboru s názvem 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>

Následuje ukázka dat mapy webu pro předchozí příklad.

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

Poznámky

Třída MenuEventArgs se používá k ukládání dat událostí předaných obslužné rutině události pro události v následující tabulce.

Událost Description
MenuItemClick Nastane při kliknutí na položku nabídky. Tato událost se běžně používá k synchronizaci Menu ovládacího prvku s jiným ovládacím prvek na stránce.
MenuItemDataBound Nastane, když je položka nabídky svázaná s daty. Tato událost se běžně používá k úpravě položky nabídky před jejím vykreslení v ovládacím Menu prvku.

V závislosti na vyvolané události můžete pomocí Item vlastnosti přistupovat k položce nabídky, na kterou uživatel klikl, nebo k položce nabídky vázané na data.

Seznam počátečních hodnot vlastností pro instanci MenuEventArgs třídy naleznete v konstruktoru MenuEventArgs .

Konstruktory

MenuEventArgs(MenuItem)

Inicializuje novou instanci MenuEventArgs třídy pomocí zadané položky nabídky.

MenuEventArgs(MenuItem, Object, CommandEventArgs)

Inicializuje novou instanci MenuEventArgs třídy pomocí zadané položky nabídky, zdroje příkazů a argumentů události.

Vlastnosti

CommandArgument

Získá argument pro příkaz.

(Zděděno od CommandEventArgs)
CommandName

Získá název příkazu.

(Zděděno od CommandEventArgs)
CommandSource

Získá událost Object , která vyvolala událost.

Item

Získá položku nabídky přidruženou k události vyvolané.

Metody

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Platí pro

Viz také