MenuEventArgs Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

EventArgs

CommandEventArgs
MenuEventArgs

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>

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