Udostępnij za pośrednictwem


MenuEventArgs Klasa

Definicja

Dostarcza dane dla zdarzeń MenuItemClick i MenuItemDataBound kontrolki Menu . Klasa ta nie może być dziedziczona.

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
Dziedziczenie

Przykłady

W poniższym przykładzie kodu pokazano, jak użyć obiektu przekazanego MenuEventArgs do programu obsługi zdarzeń dla MenuItemDataBound zdarzenia w celu zmodyfikowania właściwości elementu menu przed wyświetleniem go w kontrolce Menu . Właściwość ImageUrlHome elementu menu jest ustawiona na wyświetlanie obrazu tylko w tym elemencie menu. Aby ten przykład działał poprawnie, należy skopiować przykładowe dane mapy witryny poniżej do pliku o nazwie 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>

Poniżej przedstawiono przykładowe dane mapy witryny dla poprzedniego przykładu.

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

Uwagi

Klasa MenuEventArgs służy do przechowywania danych zdarzeń przekazywanych do programu obsługi zdarzeń dla zdarzeń w poniższej tabeli.

Zdarzenie Opis
MenuItemClick Występuje po kliknięciu elementu menu. To zdarzenie jest często używane do synchronizowania kontrolki Menu z inną kontrolką na stronie.
MenuItemDataBound Występuje, gdy element menu jest powiązany z danymi. To zdarzenie jest często używane do modyfikowania elementu menu przed jego renderowaniem w kontrolce Menu .

W zależności od zgłoszonego zdarzenia można uzyskać dostęp do elementu menu klikniętego przez użytkownika lub element menu powiązany z danymi przy użyciu Item właściwości .

Aby uzyskać listę początkowych wartości właściwości dla wystąpienia MenuEventArgs klasy, zobacz MenuEventArgs konstruktor.

Konstruktory

MenuEventArgs(MenuItem)

Inicjuje MenuEventArgs nowe wystąpienie klasy przy użyciu określonego elementu menu.

MenuEventArgs(MenuItem, Object, CommandEventArgs)

Inicjuje nowe wystąpienie MenuEventArgs klasy przy użyciu określonego elementu menu, źródła poleceń i argumentów zdarzeń.

Właściwości

CommandArgument

Pobiera argument polecenia .

(Odziedziczone po CommandEventArgs)
CommandName

Pobiera nazwę polecenia.

(Odziedziczone po CommandEventArgs)
CommandSource

Pobiera zdarzenie Object , które wywołało zdarzenie.

Item

Pobiera element menu skojarzony ze zgłoszonym zdarzeniem.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Zobacz też