Freigeben über


MenuEventArgs Klasse

Definition

Stellt Daten für das MenuItemClick-Ereignis und das MenuItemDataBound-Ereignis eines Menu-Steuerelements bereit. Diese Klasse kann nicht vererbt werden.

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
Vererbung

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das MenuEventArgs an den Ereignishandler übergebene -Objekt für das MenuItemDataBound Ereignis verwendet wird, um die Eigenschaften eines Menüelements zu ändern, bevor es in einem Menu Steuerelement angezeigt wird. Die ImageUrl -Eigenschaft des Home Menüelements ist so festgelegt, dass nur ein Bild in diesem Menüelement angezeigt wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die unten angegebenen Beispiel-Siteübersichtsdaten in eine Datei namens Web.sitemap kopieren.


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

Im Folgenden finden Sie Beispiel-Siteübersichtsdaten für das vorherige Beispiel.

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

Hinweise

Die MenuEventArgs -Klasse wird verwendet, um die Ereignisdaten zu speichern, die an einen Ereignishandler für die Ereignisse in der folgenden Tabelle übergeben werden.

Ereignis Beschreibung
MenuItemClick Tritt auf, wenn auf ein Menüelement geklickt wird. Dieses Ereignis wird häufig verwendet, um ein Steuerelement mit einem Menu anderen Steuerelement auf der Seite zu synchronisieren.
MenuItemDataBound Tritt auf, wenn ein Menüelement an Daten gebunden ist. Dieses Ereignis wird häufig verwendet, um ein Menüelement zu ändern, bevor es in einem Menu Steuerelement gerendert wird.

Je nach ausgelöstem Ereignis können Sie mithilfe der -Eigenschaft auf das Menüelement zugreifen, auf das der Benutzer geklickt hat, oder auf das Menüelement, das Item an Daten gebunden ist.

Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz der MenuEventArgs-Klasse finden Sie im MenuEventArgs-Konstruktor.

Konstruktoren

MenuEventArgs(MenuItem)

Initialisiert eine neue Instanz der MenuEventArgs-Klasse unter Verwendung des angegebenen Menüelements.

MenuEventArgs(MenuItem, Object, CommandEventArgs)

Initialisiert eine neue Instanz der MenuEventArgs-Klasse unter Verwendung des angegebenen Menüelements, der Befehlsquelle und der Ereignisargumente.

Eigenschaften

CommandArgument

Ruft das Argument für den Befehl ab.

(Geerbt von CommandEventArgs)
CommandName

Ruft den Namen des Befehls ab.

(Geerbt von CommandEventArgs)
CommandSource

Ruft das Object ab, das das Ereignis ausgelöst hat.

Item

Ruft das Menüelement ab, das dem ausgelösten Ereignis zugeordnet ist.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen