Sdílet prostřednictvím

MenuEventArgs Třída

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Poskytuje data pro MenuItemClick ovládací prvek a MenuItemDataBound události Menu . Tuto třídu nelze zdě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
Object
EventArgs
CommandEventArgs
MenuEventArgs

Příklady

Následující příklad kódu ukazuje, jak použít MenuEventArgs objekt předaný obslužné MenuItemDataBound rutině události události k úpravě 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 níže uvedená ukázková data mapy webu do souboru s názvem Web.mapa webu.


<%@ 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 slouží k ukládání dat události předávané obslužné rutině události pro události v následující tabulce.

Zvláštní událost Description
MenuItemClick Nastane při kliknutí na položku nabídky. Tato událost se běžně používá k synchronizaci ovládacího prvku s jiným ovládacím Menu prvku 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 vykreslením v ovládacím Menu prvku.

V závislosti na vyvolané události můžete získat přístup k položce nabídky, na kterou uživatel klikne, nebo položku nabídky, která je svázaná s daty, pomocí Item vlastnosti.

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

Konstruktory

Name Description
MenuEventArgs(MenuItem, Object, CommandEventArgs)

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

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

Vlastnosti

Name Description
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 vyvolání události.

Metody

Name Description
Equals(Object)

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

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

Slouží jako výchozí funkce hash.

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

Získá Type aktuální instance.

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

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

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