MenuItem Klasse

Definition

Stellt ein Menüelement dar, das im MenuSteuerelement angezeigt wird.Represents a menu item displayed in the Menu control. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class MenuItem sealed : ICloneable, System::Web::UI::IStateManager
public sealed class MenuItem : ICloneable, System.Web.UI.IStateManager
type MenuItem = class
    interface IStateManager
    interface ICloneable
Public NotInheritable Class MenuItem
Implements ICloneable, IStateManager
Vererbung
MenuItem
Implementiert

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Menu -Steuerelement mithilfe von deklarativer Syntax mit statischen MenuItem -Objekten aufgefüllt wird.The following example demonstrates how to populate a Menu control with static MenuItem objects using declarative syntax.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Declarative Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Declarative Example</h3>
    
      <!-- Use declarative syntax to create the   -->
      <!-- menu structure. Create submenu items   -->
      <!-- by nesting them within parent menu     -->
      <!-- items.                                 -->
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="1"
        staticsubmenuindent="10" 
        orientation="Vertical" 
        target="_blank"  
        runat="server">

        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            imageurl="Images\Home.gif"
            popoutimageurl="Images\Popout.jpg"   
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              popoutimageurl="Images\Popout.jpg"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              popoutimageurl="Images\Popout.jpg"              
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

    </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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Declarative Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Declarative Example</h3>
    
      <!-- Use declarative syntax to create the   -->
      <!-- menu structure. Create submenu items   -->
      <!-- by nesting them within parent menu     -->
      <!-- items.                                 -->
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="1"
        staticsubmenuindent="10" 
        orientation="Vertical" 
        target="_blank"  
        runat="server">

        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            imageurl="Images\Home.gif"
            popoutimageurl="Images\Popout.jpg"   
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              popoutimageurl="Images\Popout.jpg"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              popoutimageurl="Images\Popout.jpg"              
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

    </form>
  </body>
</html>

Im folgenden Beispiel wird veranschaulicht, wie ein Menu -Steuerelement SiteMapDataSource an ein-Steuerelement gebunden wird.The following example demonstrates how to bind a Menu control to a SiteMapDataSource control. Wenn das Menu Steuerelement an eine Datenquelle gebunden ist, erstellt MenuItem es automatisch die Objekte.When bound to a data source, the Menu control automatically creates the MenuItem objects. 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">
<html xmlns="http://www.w3.org/1999/xhtml" >

  <!-- For the hover styles of the Menu control to  -->
  <!-- work correctly, you must include this head   -->
  <!-- element.                                     -->
  <head runat="server">
    <title>Menu DataBinding Example</title>
</head>

  <body>
    <form id="form1" runat="server">
    
      <h3>Menu DataBinding Example</h3>
    
      <!-- Bind the Menu control to a SiteMapDataSource control.  -->
      <asp:menu id="NavigationMenu"
        disappearafter="2000"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        font-names="Arial" 
        target="_blank"
        datasourceid="MenuSource"   
        runat="server">
        
        <staticmenuitemstyle backcolor="LightSteelBlue"
          forecolor="Black"/>
        <statichoverstyle backcolor="LightSkyBlue"/>
        <dynamicmenuitemstyle backcolor="Black"
          forecolor="Silver"/>
        <dynamichoverstyle backcolor="LightSkyBlue"
          forecolor="Black"/>

      </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">
<html xmlns="http://www.w3.org/1999/xhtml" >

  <!-- For the hover styles of the Menu control to  -->
  <!-- work correctly, you must include this head   -->
  <!-- element.                                     -->
  <head runat="server">
    <title>Menu DataBinding Example</title>
</head>

  <body>
    <form id="form1" runat="server">
    
      <h3>Menu DataBinding Example</h3>
    
      <!-- Bind the Menu control to a SiteMapDataSource control.  -->
      <asp:menu id="NavigationMenu"
        disappearafter="2000"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        font-names="Arial" 
        target="_blank"
        datasourceid="MenuSource"   
        runat="server">
        
        <staticmenuitemstyle backcolor="LightSteelBlue"
          forecolor="Black"/>
        <statichoverstyle backcolor="LightSkyBlue"/>
        <dynamicmenuitemstyle backcolor="Black"
          forecolor="Silver"/>
        <dynamichoverstyle backcolor="LightSkyBlue"
          forecolor="Black"/>

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

Ein Menu -Steuerelement besteht aus einer Hierarchie von Menü Elementen, MenuItem die durch-Objekte dargestellt werden.A Menu control is made up of a hierarchy of menu items represented by MenuItem objects. Jedes Menü Element verfügt über eine Depth schreibgeschützte Eigenschaft, die die Ebene angibt, bei der das Menü Element Menu im Steuerelement angezeigt wird.Each menu item has a read-only Depth property that specifies the level at which the menu item is displayed in the Menu control. Menü Elemente auf der obersten Ebene (Ebene 0), die nicht über ein übergeordnetes Menü Element verfügen, werden als Stamm Menü Elemente bezeichnet.Menu items at the top level (level 0) that do not have a parent menu item are called root menu items. Ein Menü Element, das über ein übergeordnetes Menü Element verfügt, wird als unter Menü Element bezeichnet.A menu item that has a parent menu item is called a submenu item. Alle Stamm Menü Elemente werden in der Items Auflistung gespeichert.All root menu items are stored in the Items collection. Unter Menü Elemente werden in der ChildItems Auflistung eines übergeordneten Menü Elements gespeichert.Submenu items are stored in a parent menu item's ChildItems collection. Mithilfe der Parent -Eigenschaft können Sie auf das übergeordnete Menü Element eines Menü Elements zugreifen.You can access a menu item's parent menu item by using the Parent property.

Hinweis

Die Items - ChildItems Auflistung und die-Auflistung enthalten nur die Menü Elemente für die nächste Ebene.The Items and ChildItems collections contain only the menu items for the next level down. Wenn Sie auf Menü Elemente weiter unten in der Menüstruktur zugreifen ChildItems möchten, verwenden Sie die-Eigenschaft eines nachfolgenden Menü Elements.To access menu items further down the menu tree, use the ChildItems property of a subsequent menu item.

Um die Menü Elemente für ein Menu Steuerelement zu erstellen, verwenden Sie eine der folgenden Methoden:To create the menu items for a Menu control, use one of the following methods:

Verwenden Sie die deklarative Syntax, um statische Menü Elemente zu erstellen.Use declarative syntax to create static menu items.

Verwenden Sie einen Konstruktor, um dynamisch neue Instanzen der MenuItem -Klasse zu erstellen.Use a constructor to dynamically create new instances of the MenuItem class. Diese MenuItem Objekte können dann der-Auflistung oder Items ChildItems der-Auflistung hinzugefügt werden.These MenuItem objects can then be added to the Items or ChildItems collection.

Binden Sie Menu das Steuerelement an eine Datenquelle.Bind the Menu control to a data source. Wenn das Menu Steuerelement an ein SiteMapDataSource Steuerelement gebunden MenuItem ist, werden automatisch-Objekte erstellt, die den Elementen in der Datenquelle entsprechen.When the Menu control is bound to a SiteMapDataSource control, MenuItem objects are automatically created that correspond to the items in the data source. Bei anderen Datenquellen MenuItem werden Objekte auch automatisch erstellt, die der Hierarchiestruktur der Datenquelle entsprechen. Sie müssen jedoch auch die DataBindings Auflistung verwenden, um die Menü Element Bindungen zu definieren, die die Bindungs Beziehung angeben. zwischen einem Menü Element und dem zugehörigen Datenelement.For other data sources, MenuItem objects are also automatically created that match the hierarchy structure of data source; however, you must also use the DataBindings collection to define the menu item bindings that specify the binding relationship between a menu item and its corresponding data item.

Die Menü Elemente werden je nach Ebene entweder in einem statischen Menü oder in einem dynamischen Menü angezeigt.The menu items are displayed in either a static menu or a dynamic menu, depending on its level. Das statische Menü wird immer in einem Menu -Steuerelement angezeigt.The static menu is always displayed in a Menu control. Standardmäßig werden die Menü Elemente auf der obersten Ebene (Ebene 0) im statischen Menü angezeigt.By default, the menu items at the top level (level 0) are displayed in the static menu. Sie können zusätzliche Menüebenen (statische Untermenüs) im statischen Menü anzeigen, indem Sie die StaticDisplayLevels -Eigenschaft festlegen.You can display additional menu levels (static submenus) within the static menu by setting the StaticDisplayLevels property. Menü Elemente (sofern vorhanden) mit einer höheren Ebene als der Wert, der von StaticDisplayLevels der-Eigenschaft angegeben wird, werden in einem dynamischen Untermenü angezeigt.Menu items (if any) with a higher level than the value specified by the StaticDisplayLevels property are displayed in a dynamic submenu. Ein dynamisches Untermenü wird nur angezeigt, wenn der Benutzer den Mauszeiger über dem übergeordneten Menü Element positioniert, das ein dynamisches Untermenü enthält.A dynamic submenu appears only when the user positions the mouse pointer over the parent menu item that contains a dynamic submenu.

Wenn der Benutzer auf ein Menü Element klickt, Menu kann das Steuerelement entweder zu einer verknüpften Webseite navigieren oder einfach an den Server zurücksenden.When the user clicks a menu item, the Menu control can either navigate to a linked Web page or simply post back to the server. Wenn die NavigateUrl -Eigenschaft eines Menü Elements festgelegt wird, Menu navigiert das-Steuerelement zur verknüpften Seite; andernfalls wird die Seite zur Verarbeitung an den Server zurückgesendet.If the NavigateUrl property of a menu item is set, the Menu control navigates to the linked page; otherwise, it posts the page back to the server for processing. Standardmäßig wird eine verknüpfte Seite im gleichen Fenster oder Frame angezeigt wie das Menu Steuerelement.By default, a linked page is displayed in the same window or frame as the Menu control. Um den verknüpften Inhalt in einem anderen Fenster oder Frame anzuzeigen, verwenden Target Sie die- Menu Eigenschaft des-Steuer Elements.To display the linked content in a different window or frame, use the Target property of the Menu control.

Hinweis

Die Menu.Target -Eigenschaft wirkt sich auf alle Menü Elemente im-Steuerelement aus.The Menu.Target property affects every menu item in the control. Wenn Sie ein Fenster oder einen Frame für ein einzelnes Menü Element angeben möchten Target , legen Sie MenuItem die-Eigenschaft des-Objekts direkt fest.To specify a window or frame for an individual menu item, set the Target property of the MenuItem object directly.

Jedes Menü Element verfügt über Text eine- Value Eigenschaft und eine-Eigenschaft.Each menu item has a Text and a Value property. Der Wert der Text -Eigenschaft wird Menu im-Steuerelement angezeigt, während Value die-Eigenschaft zum Speichern zusätzlicher Daten über das Menü Element verwendet wird, z. b. Daten, die an das dem Menü Element zugeordnete Post Back Ereignis weitergegeben werden.The value of the Text property is displayed in the Menu control, while the Value property is used to store any additional data about the menu item, such as data passed to the postback event associated with the menu item. Wenn Sie die Text -Eigenschaft festlegen, aber die Value -Eigenschaft nicht festgelegt Value lassen, wird die-Eigenschaft automatisch mit dem gleichen Text Wert wie die-Eigenschaft festgelegt.If you set the Text property, but leave the Value property unset, the Value property is automatically set with the same value as the Text property. Das Gegenteil gilt auch für.The opposite is also true. Wenn Sie die Value -Eigenschaft, jedoch nicht die Text -Eigenschaft festlegen Text , wird die-Eigenschaft automatisch mit dem gleichen Wert Value wie die-Eigenschaft festgelegt.If you set the Value property, but not the Text property, the Text property is automatically set with the same value as the Value property.

Hinweis

Menü Elemente auf der gleichen Menü Ebene müssen jeweils einen eindeutigen Wert für die Value -Eigenschaft aufweisen. das Menu Steuerelement kann nicht zwischen verschiedenen Menü Elementen auf derselben Ebene unterscheiden, die denselben Wert aufweisen.Menu items at the same menu level must each have a unique value for the Value property; the Menu control cannot distinguish between different menu items at the same level that have the same value. Wenn der Benutzer in diesem Szenario auf ein Menü Element klickt, das einen doppelten Wert hat, wird das Menü Element ausgewählt, das zuerst im Menü angezeigt wird.In this scenario, if the user clicks a menu item that has a duplicate value, the menu item that appears first in the menu is selected.

Um eine QuickInfo anzuzeigen, wenn der Benutzer den Mauszeiger über einem Menü Element positioniert, legen Sie ToolTip die-Eigenschaft des Elements fest.To display a ToolTip when the user positions the mouse pointer over a menu item, set the item's ToolTip property.

Ein Menu -Steuerelement verfügt über mehrere verschiedene Typen von Menü Elementen.A Menu control has several different types of menu items. Sie können den Stil (z. b. Schriftart Größe und-Farbe) für die unterschiedlichen Menü Elementtypen steuern, indem Sie die Eigenschaften in der folgenden Tabelle verwenden.You can control the style (such as font size and color) for the different menu item types by using the properties in the following table.

Menü Element Stil (Eigenschaft)Menu item style property BeschreibungDescription
DynamicHoverStyle Die Stileinstellungen für ein dynamisches Menü Element, wenn der Mauszeiger darauf positioniert ist.The style settings for a dynamic menu item when the mouse pointer is positioned over it.
DynamicMenuItemStyle Die Stileinstellungen für ein einzelnes dynamisches Menü Element.The style settings for an individual dynamic menu item.
DynamicMenuStyle Die Stileinstellungen für ein dynamisches Menü.The style settings for a dynamic menu.
DynamicSelectedStyle Die Stileinstellungen für das aktuell ausgewählte dynamische Menü Element.The style settings for the currently selected dynamic menu item.
StaticHoverStyle Die Stileinstellungen für ein statisches Menü Element, wenn der Mauszeiger darauf positioniert ist.The style settings for a static menu item when the mouse pointer is positioned over it.
StaticMenuItemStyle Die Stileinstellungen für ein einzelnes statisches Menü Element.The style settings for an individual static menu item.
StaticMenuStyle Die Stileinstellungen für ein statisches Menü.The style settings for a static menu.
StaticSelectedStyle Die Stileinstellungen für das aktuell ausgewählte statische Menü Element.The style settings for the currently selected static menu item.

Anstatt die einzelnen Stileigenschaften festzulegen, können Sie mithilfe der in der folgenden Tabelle gezeigten Stil Auflistungen Stile angeben, die auf die Menü Elemente basierend auf ihrer Ebene angewendet werden.Instead of setting the individual style properties, you can specify styles that are applied to menu items based on their level by using the style collections shown in the following table.

Sammlungen auf EbeneLevel style collections BeschreibungDescription
LevelMenuItemStyles Eine Auflistung von MenuItemStyle -Objekten, die den Stil der Menü Elemente basierend auf ihrer Ebene steuern.A collection of MenuItemStyle objects that control the style of the menu items based on their level.
LevelSelectedStyles Eine Auflistung von MenuItemStyle -Objekten, die den Stil ausgewählter Menü Elemente basierend auf ihrer Ebene steuern.A collection of MenuItemStyle objects that control the style of selected menu items based on their level.
LevelSubMenuStyles Eine Auflistung von MenuItemStyle -Objekten, die den Stil der unter Menü Elemente basierend auf ihrer Ebene steuern.A collection of MenuItemStyle objects that control the style of the submenu items based on their level.

Der erste Stil in der Auflistung entspricht dem Stil der Menü Elemente auf der ersten tiefen Ebene in der Menüstruktur.The first style in the collection corresponds to the style of the menu items at the first depth level in the menu tree. Der zweite Stil in der Auflistung entspricht dem Stil der Menü Elemente auf der zweiten tiefen Ebene in der Menüstruktur usw.The second style in the collection corresponds to the style of the menu items at the second depth level in the menu tree, and so on. Dies wird am häufigsten verwendet, um Inhalts Stil-Navigationsmenüs zu generieren, bei denen Menü Elemente in einer bestimmten Tiefe die gleiche Darstellung aufweisen sollten, unabhängig davon, ob Sie über Untermenüs verfügen.This is most often used to generate table of contents-style navigation menus where menu items at a certain depth should have the same appearance, regardless of whether they have submenus.

Hinweis

Wenn Sie eine der in der vorherigen Tabelle aufgeführten Ebenen-Auflistungen verwenden, um den Stil für Menu das Steuerelement zu definieren, überschreiben diese Stileinstellungen die einzelnen Menü Element-Stileigenschaften.If you use any of the level style collections listed in the previous table to define the style for the Menu control, these style settings override the individual menu item style properties.

Zusätzlich zum Anpassen des Stils eines Menü Elements können Sie auch seine Darstellung anpassen.In addition to customizing a menu item's style, you can also customize its appearance. Sie können benutzerdefinierte Images für die verschiedenen Teile für ein Menü Element angeben, indem Sie die Eigenschaften in der folgenden Tabelle festlegen.You can specify custom images for the different parts for a menu item by setting the properties in the following table.

Image-EigenschaftImage property BeschreibungDescription
ImageUrl Ein optionales Bild, das neben dem Text eines Menü Elements angezeigt wird.An optional image displayed next to the text of a menu item.
PopOutImageUrl Ein optionales Bild, das in einem Menü Element angezeigt wird und angibt, dass das Menü Element über ein dynamisches Untermenü verfügt.An optional image displayed in a menu item to indicate that the menu item has a dynamic submenu.
SeparatorImageUrl Ein optionales Bild, das am unteren Rand eines Menü Elements angezeigt wird, um es von anderen Menü Elementen zu trennen.An optional image displayed at the bottom of a menu item to separate it from other menu items.

Verwenden Sie die Selected -Eigenschaft, um zu bestimmen, ob Menu ein Menü Element zurzeit in einem-Steuerelement ausgewählt ist.To determine whether a menu item is currently selected in a Menu control, use the Selected property. Mithilfe der DataBound -Eigenschaft können Sie auch bestimmen, ob ein Menü Element an Daten gebunden ist.You can also determine whether a menu item is bound to data by using the DataBound property. Wenn ein Menü Element an Daten gebunden ist, können Sie die DataItem -Eigenschaft verwenden, um auf die Werte des Datenelements zuzugreifen, das an das Menü Element gebunden ist.If a menu item is bound to data, you can use the DataItem property to access the values of the data item bound to the menu item.

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

Konstruktoren

MenuItem()

Initialisiert eine neue Instanz der MenuItem-Klasse ohne einen Menütext oder einen Wert.Initializes a new instance of the MenuItem class without menu text or a value.

MenuItem(String)

Initialisiert mithilfe des angegebenen Menütexts eine neue Instanz der MenuItem-Klasse.Initializes a new instance of the MenuItem class using the specified menu text.

MenuItem(String, String)

Initialisiert mithilfe des angegebenen Menütexts und des angegebenen Werts eine neue Instanz der MenuItem-Klasse.Initializes a new instance of the MenuItem class using the specified menu text and value.

MenuItem(String, String, String)

Initialisiert eine neue Instanz der MenuItem-Klasse unter Verwendung des angegebenen Menütexts, des Werts sowie der URL zu einem Bild.Initializes a new instance of the MenuItem class using the specified menu text, value, and URL to an image.

MenuItem(String, String, String, String)

Initialisiert eine neue Instanz der MenuItem-Klasse unter Verwendung des angegebenen Menütexts, des Werts sowie der URL zu einem Bild und der URL für die Navigation.Initializes a new instance of the MenuItem class using the specified menu text, value, image URL, and navigation URL.

MenuItem(String, String, String, String, String)

Initialisiert eine neue Instanz der MenuItem-Klasse unter Verwendung des angegebenen Menütexts, des Werts, der URL zu einem Bild, der URL für die Navigation sowie eines Ziels.Initializes a new instance of the MenuItem class using the specified menu text, value, image URL, navigation URL, and target.

Eigenschaften

ChildItems

Ruft ein MenuItemCollection-Objekt ab, das die Untermenüelemente des aktuellen Menüelements enthält.Gets a MenuItemCollection object that contains the submenu items of the current menu item.

DataBound

Ruft einen Wert ab, der angibt, ob das Menüelement durch Datenbindung erstellt wurde.Gets a value indicating whether the menu item was created through data binding.

DataItem

Ruft das Datenelement ab, das an das Menüelement gebunden ist.Gets the data item that is bound to the menu item.

DataPath

Ruft den Pfad zu den Daten ab, die an das Menüelement gebunden sind.Gets the path to the data that is bound to the menu item.

Depth

Ruft die Ebene ab, auf der ein Menüelement angezeigt wird.Gets the level at which a menu item is displayed.

Enabled

Ruft einen Wert ab, der angibt, ob das MenuItem-Objekt aktiviert ist, sodass das Element ein Popoutbild sowie vorhandene untergeordnete Menüelemente anzeigen kann, oder legt diesen Wert fest.Gets or sets a value that indicates whether the MenuItem object is enabled, allowing the item to display a pop-out image and any child menu items.

ImageUrl

Ruft die URL zu einem Bild ab, das neben dem Text im Menüelement angezeigt wird, oder legt diese URL fest.Gets or sets the URL to an image that is displayed next to the text in a menu item.

NavigateUrl

Ruft die URL ab, zu der beim Klicken auf das Menüelement navigiert werden soll, oder legt diese fest.Gets or sets the URL to navigate to when the menu item is clicked.

Parent

Ruft das übergeordnete Menüelement des aktuellen Menüelements ab.Gets the parent menu item of the current menu item.

PopOutImageUrl

Ruft die URL zu einem Bild ab oder legt eine URL zu einem Bild fest, das in einem Menüelement angezeigt wird und angibt, dass dieses Menüelement über ein dynamisches Untermenü verfügt.Gets or sets the URL to an image that is displayed in a menu item to indicate that the menu item has a dynamic submenu.

Selectable

Ruft einen Wert ab, der angibt, ob das MenuItem-Objekt ausgewählt werden kann oder ob darauf geklickt werden kann, oder legt diesen Wert fest.Gets or sets a value that indicates whether the MenuItem object can be selected, or is "clickable."

Selected

Ruft einen Wert ab, der angibt, ob das aktuelle Menüelement in einem Menu-Steuerelement ausgewählt ist, oder legt diesen Wert fest.Gets or sets a value indicating whether the current menu item is selected in a Menu control.

SeparatorImageUrl

Ruft eine URL zu einem Bild ab oder legt die URL zu einem Bild fest, das am unteren Rand eines Menüelements angezeigt werden soll, um das Menüelement von anderen Menüelementen abzugrenzen.Gets or sets the URL to an image displayed at the bottom of a menu item to separate it from other menu items.

Target

Ruft das Zielfenster oder den Zielframe ab, in dem die einem Menüeelement zugeordneten Webseiteninhalte angezeigt werden sollen, oder legt dieses Zielfenster bzw. den Zielframe fest.Gets or sets the target window or frame in which to display the Web page content associated with a menu item.

Text

Ruft den Text ab oder legt den Text fest, der in einem Menu-Steuerelement für das Menüelement angezeigt wird.Gets or sets the text displayed for the menu item in a Menu control.

ToolTip

Ruft den QuickInfo-Text für das Menüelement ab oder legt diesen fest.Gets or sets the ToolTip text for the menu item.

Value

Ruft einen nicht angezeigten Wert ab, mit dem zusätzliche Daten zum Menüelement gespeichert werden (z. B. Daten zum Behandeln eines Postbackereignisses), oder legt diesen Wert fest.Gets or sets a non-displayed value used to store any additional data about the menu item, such as data used for handling postback events.

ValuePath

Ruft den Pfad vom Stammmenüelement zum aktuellen Menüelement ab.Gets the path from the root menu item to the current menu item.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

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

(Geerbt von Object)
MemberwiseClone()

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

(Geerbt von Object)
ToString()

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

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()

Erstellt eine Kopie des aktuellen MenuItem-Objekts.Creates a copy of the current MenuItem object.

IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das MenuItem-Objekt Änderungen des Ansichtszustands speichert.Gets a value that indicates whether the MenuItem object is saving changes to its view state.

IStateManager.LoadViewState(Object)

Lädt den zuvor gespeicherten Ansichtszustand des Menüelements.Loads the menu item's previously saved view state.

IStateManager.SaveViewState()

Speichert die Änderungen am Ansichtszustand für ein Object.Saves the view-state changes to an Object.

IStateManager.TrackViewState()

Weist das MenuItem-Objekt an, Änderungen am Ansichtszustand nachzuverfolgen.Instructs the MenuItem object to track changes to its view state.

Gilt für:

Siehe auch