MenuEventArgs Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

EventArgs

CommandEventArgs
MenuEventArgs

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>

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