MenuEventArgs MenuEventArgs MenuEventArgs MenuEventArgs Class

Definition

Stellt Daten für das MenuItemClick-Ereignis und das MenuItemDataBound-Ereignis eines Menu-Steuerelements bereit.Provides data for the MenuItemClick and MenuItemDataBound events of a Menu control. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

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 -Objekt verwendet wird, das an den MenuItemDataBound -Ereignishandler für das-Ereignis geleitet wird, um die Eigenschaften eines Menü Menu Elements zu ändern, bevor es in einem-Steuerelement angezeigt wirdThe following code example demonstrates how to use the MenuEventArgs object passed to the event handler for the MenuItemDataBound event to modify the properties of a menu item before it is displayed in a Menu control. Die ImageUrl -Eigenschaft Home des Menü Elements wird so festgelegt, dass nur ein Bild in diesem Menü Element angezeigt wird.The ImageUrl property of the Home menu item is set to display an image in that menu item only. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die Beispiel Daten der Site Map unten in eine Datei mit dem Namen "Web. Sitemap" kopieren.For this example to work correctly, you must copy the sample site map data below to a file named 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>

Im folgenden finden Sie Beispiele für Site Übersichts Daten für das vorherige Beispiel.The following is sample site map data for the previous example.

<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 übermittelt werden.The MenuEventArgs class is used to store the event data passed to an event handler for the events in the following table.

eventEvent BeschreibungDescription
MenuItemClick Tritt auf, wenn auf ein Menü Element geklickt wird.Occurs when a menu item is clicked. Dieses Ereignis wird häufig verwendet, um ein Menu Steuerelement mit einem anderen Steuerelement auf der Seite zu synchronisieren.This event is commonly used to synchronize a Menu control with another control on the page.
MenuItemDataBound Tritt ein, wenn ein Menü Element an Daten gebunden wird.Occurs when a menu item is bound to data. Dieses Ereignis wird häufig verwendet, um ein Menü Element zu ändern, bevor es in Menu einem-Steuerelement gerendert wird.This event is commonly used to modify a menu item before it is rendered in a Menu control.

Je nachdem, welches Ereignis ausgelöst wird, können Sie auf das Menü Element zugreifen, auf das der Benutzer geklickt hat, oder auf das Menü Item Element, das mit der-Eigenschaft an Daten gebunden wird.Depending on the event raised, you can access the menu item clicked by the user or the menu item being bound to data by using the Item property.

Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz der MenuEventArgs-Klasse finden Sie im MenuEventArgs-Konstruktor.For a list of initial property values for an instance of the MenuEventArgs class, see the MenuEventArgs constructor.

Konstruktoren

MenuEventArgs(MenuItem) MenuEventArgs(MenuItem) MenuEventArgs(MenuItem) MenuEventArgs(MenuItem)

Initialisiert eine neue Instanz der MenuEventArgs-Klasse unter Verwendung des angegebenen Menüelements.Initializes a new instance of the MenuEventArgs class using the specified menu item.

MenuEventArgs(MenuItem, Object, CommandEventArgs) MenuEventArgs(MenuItem, Object, CommandEventArgs) MenuEventArgs(MenuItem, Object, CommandEventArgs) MenuEventArgs(MenuItem, Object, CommandEventArgs)

Initialisiert eine neue Instanz der MenuEventArgs-Klasse unter Verwendung des angegebenen Menüelements, der Befehlsquelle und der Ereignisargumente.Initializes a new instance of the MenuEventArgs class using the specified menu item, command source, and event arguments.

Eigenschaften

CommandArgument CommandArgument CommandArgument CommandArgument

Ruft das Argument für den Befehl ab.Gets the argument for the command.

(Inherited from CommandEventArgs)
CommandName CommandName CommandName CommandName

Ruft den Namen des Befehls ab.Gets the name of the command.

(Inherited from CommandEventArgs)
CommandSource CommandSource CommandSource CommandSource

Ruft das Object ab, das das Ereignis ausgelöst hat.Gets the Object that raised the event.

Item Item Item Item

Ruft das Menüelement ab, das dem ausgelösten Ereignis zugeordnet ist.Gets the menu item associated with the event raised.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch