MenuItemCollection MenuItemCollection MenuItemCollection MenuItemCollection Class

Definition

Stellt eine Auflistung von Menüelementen in einem Menu-Steuerelement dar.Represents a collection of menu items in a Menu control. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class MenuItemCollection sealed : System::Collections::ICollection, System::Web::UI::IStateManager
public sealed class MenuItemCollection : System.Collections.ICollection, System.Web.UI.IStateManager
type MenuItemCollection = class
    interface ICollection
    interface IEnumerable
    interface IStateManager
Public NotInheritable Class MenuItemCollection
Implements ICollection, IStateManager
Vererbung
MenuItemCollectionMenuItemCollectionMenuItemCollectionMenuItemCollection
Implementiert

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie zum Auffüllen der Items und ChildItems Sammlungen, die mit deklarativer Syntax.The following code example demonstrates how to populate the Items and ChildItems collections 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" >

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

  <body>
    <form id="form1" runat="server">
    
      <h3>Menu Declarative Example</h3>
    
      <!-- Use declarative syntax to create the   -->
      <!-- menu structure. Submenu items are      -->
      <!-- created by nesting them in parent menu -->
      <!-- items.                                 -->
      <asp:menu id="NavigationMenu"
        disappearafter="2000"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        font-names="Arial" 
        target="_blank"  
        runat="server">
        
        <staticmenuitemstyle backcolor="LightSteelBlue"
          forecolor="Black"/>
        <statichoverstyle backcolor="LightSkyBlue"/>
        <dynamicmenuitemstyle backcolor="Black"
          forecolor="Silver"/>
        <dynamichoverstyle backcolor="LightSkyBlue"
          forecolor="Black"/>
      
        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                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" >

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

  <body>
    <form id="form1" runat="server">
    
      <h3>Menu Declarative Example</h3>
    
      <!-- Use declarative syntax to create the   -->
      <!-- menu structure. Submenu items are      -->
      <!-- created by nesting them in parent menu -->
      <!-- items.                                 -->
      <asp:menu id="NavigationMenu"
        disappearafter="2000"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        font-names="Arial" 
        target="_blank"  
        runat="server">
        
        <staticmenuitemstyle backcolor="LightSteelBlue"
          forecolor="Black"/>
        <statichoverstyle backcolor="LightSkyBlue"/>
        <dynamicmenuitemstyle backcolor="Black"
          forecolor="Silver"/>
        <dynamichoverstyle backcolor="LightSkyBlue"
          forecolor="Black"/>
      
        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

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

Im folgenden Codebeispiel wird veranschaulicht, wie Sie programmgesteuert hinzufügen einer MenuItem -Objekt an die ChildItems Auflistung eines Menüelements Stamm.The following code example demonstrates how to programmatically add a MenuItem object to the ChildItems collection of a root menu item.


<%@ 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 Page_Load(Object sender, EventArgs e)
  {
    if (!IsPostBack)
    {
      // Retrieve the root menu item from the Items
      // collection of the Menu control using the indexer.
      MenuItem homeMenuItem = NavigationMenu.Items[0];

      // Create the submenu item.
      MenuItem newSubMenuItem = new MenuItem("New Category");

      // Add the submenu item to the ChildItems
      // collection of the root menu item.
      homeMenuItem.ChildItems.Add(newSubMenuItem);
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemCollection Add Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemCollection Add Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        runat="server">
        
        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                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">
<script runat="server">
    
  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)

    If Not IsPostBack Then

      ' Retrieve the root menu item from the Items
      ' collection of the Menu control using the indexer.
      Dim homeMenuItem As MenuItem = NavigationMenu.Items(0)

      ' Create the submenu item.
      Dim newSubMenuItem = New MenuItem("New Category")

      ' Add the submenu item to the ChildItems
      ' collection of the root menu item.
      homeMenuItem.ChildItems.Add(newSubMenuItem)
    
    End If
      
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemCollection Add Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemCollection Add Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        runat="server">
        
        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>

      </asp:menu>

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

Hinweise

Die MenuItemCollection Klasse dient zum Speichern und verwalten eine Auflistung von MenuItem Objekte in der Menu Steuerelement.The MenuItemCollection class is used to store and manage a collection of MenuItem objects in the Menu control. Die Menu -Steuerelement verwendet die MenuItemCollection -Klasse zum Speichern der Stamm-Menü-Elemente in der Items Eigenschaft.The Menu control uses the MenuItemCollection class to store its root menu items in the Items property. Diese Auflistung wird auch verwendet, für die ChildItems Eigenschaft eine MenuItem Objekt, das ein Menüelement Untermenüelemente (sofern vorhanden) gespeichert.This collection is also used for the ChildItems property of a MenuItem object to store a menu item's submenu items (if any).

Die MenuItemCollection Klasse unterstützt mehrere Möglichkeiten, die Elemente in der Auflistung zuzugreifen:The MenuItemCollection class supports several ways to access the items in the collection:

  • Verwenden der Item[Int32] Indexer direkt Abrufen einer MenuItem Objekt am angegebenen nullbasierten Index.Use the Item[Int32] indexer to directly retrieve a MenuItem object at a specific zero-based index.

  • Verwenden der GetEnumerator Methode zum Erstellen eines Enumerators, der zum Durchlaufen der Auflistung verwendet werden kann.Use the GetEnumerator method to create an enumerator that can be used to iterate through the collection.

  • Verwenden der CopyTo Methode, um den Inhalt der Auflistung in ein Array zu kopieren.Use the CopyTo method to copy the contents of the collection into an array.

Sie können programmgesteuert verwalten einer MenuItemCollection Objekt durch Hinzufügen und Entfernen von MenuItem Objekte.You can programmatically manage a MenuItemCollection object by adding and removing MenuItem objects. Verwenden Sie zum Hinzufügen von Menüelementen auf die Auflistung der Add oder AddAt Methode.To add menu items to the collection, use the Add or the AddAt method. Verwenden Sie zum Entfernen von Knoten aus der Auflistung der Remove, RemoveAt, oder die Clear Methode.To remove nodes from the collection, use the Remove, the RemoveAt, or the Clear method.

Hinweis

Wenn die Menu -Steuerelement an eine Datenquelle gebunden ist die Items und ChildItems Sammlungen werden automatisch bei jedem Auftreten einer Bindung aufgefüllt.When the Menu control is bound to a data source, the Items and ChildItems collections are automatically populated each time binding occurs. Alle Änderungen an Sammlungen zwischen Bindungen gehen verloren.Any changes to the collections between bindings will be lost. Um diese Änderungen beizubehalten, können Sie entweder aktualisieren Sie die Datenquelle oder manuell neu erstellen Sie, die jedes Mal, wenn Sie eine Bindung-Auflistung.To retain these changes, either update the data source or manually rebuild the collection each time you bind.

Die MenuItemCollection -Klasse enthält Eigenschaften und Methoden, mit denen Sie zum Abrufen von Informationen über die Auflistung selbst.The MenuItemCollection class contains properties and methods that allow you to retrieve information about the collection itself. Um herauszufinden, wie viele Elemente in der Auflistung befinden, verwenden Sie die Count Eigenschaft.To find out how many items are in the collection, use the Count property. Sollten Sie bestimmen, ob die Auflistung ein bestimmtes MenuItem -Objekts die Contains Methode.If you want to determine whether the collection contains a certain MenuItem object, use the Contains method. Den Index des abzurufenden eine MenuItem Objekt in der Auflistung, die Verwendung der IndexOf Methode.To get the index of a MenuItem object in the collection, use the IndexOf method.

Konstruktoren

MenuItemCollection() MenuItemCollection() MenuItemCollection() MenuItemCollection()

Initialisiert eine neue Instanz der MenuItemCollection-Klasse mit Standardwerten.Initializes a new instance of the MenuItemCollection class using the default values.

MenuItemCollection(MenuItem) MenuItemCollection(MenuItem) MenuItemCollection(MenuItem) MenuItemCollection(MenuItem)

Initialisiert eine neue Instanz der MenuItemCollection-Klasse unter Verwendung des angegebenen übergeordneten Menüelements (oder Besitzers).Initializes a new instance of the MenuItemCollection class using the specified parent menu item (or owner).

Eigenschaften

Count Count Count Count

Ruft die Anzahl der im aktuellen MenuItemCollection-Objekt enthaltenen Menüelemente ab.Gets the number of menu items contained in the current MenuItemCollection object.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf das MenuItemCollection-Objekt synchronisiert (threadsicher) ist.Gets a value indicating whether access to the MenuItemCollection object is synchronized (thread safe).

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ruft das MenuItem-Objekt am angegebenen Index im aktuellen MenuItemCollection-Objekt ab.Gets the MenuItem object at the specified index in the current MenuItemCollection object.

SyncRoot SyncRoot SyncRoot SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf das MenuItemCollection-Objekt synchronisiert werden kann.Gets an object that can be used to synchronize access to the MenuItemCollection object.

Methoden

Add(MenuItem) Add(MenuItem) Add(MenuItem) Add(MenuItem)

Fügt das angegebene MenuItem-Objekt an das Ende des aktuellen MenuItemCollection-Objekts an.Appends the specified MenuItem object to the end of the current MenuItemCollection object.

AddAt(Int32, MenuItem) AddAt(Int32, MenuItem) AddAt(Int32, MenuItem) AddAt(Int32, MenuItem)

Fügt das angegebene MenuItem-Objekt im aktuellen MenuItemCollection-Objekt an der angegebenen Indexposition ein.Inserts the specified MenuItem object in the current MenuItemCollection object at the specified index location.

Clear() Clear() Clear() Clear()

Entfernt alle Elemente aus dem aktuellen MenuItemCollection-Objekt.Removes all items from the current MenuItemCollection object.

Contains(MenuItem) Contains(MenuItem) Contains(MenuItem) Contains(MenuItem)

Bestimmt, ob das angegebene MenuItem-Objekt in der Auflistung vorhanden ist.Determines whether the specified MenuItem object is in the collection.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Kopiert alle Elemente aus dem MenuItemCollection-Objekt in ein kompatibles eindimensionales Array, wobei bei dem angegebenen Index des Zielarrays begonnen wird.Copies all the items from the MenuItemCollection object to a compatible one-dimensional Array, starting at the specified index in the target array.

CopyTo(MenuItem[], Int32) CopyTo(MenuItem[], Int32) CopyTo(MenuItem[], Int32) CopyTo(MenuItem[], Int32)

Kopiert alle Elemente aus dem MenuItemCollection-Objekt in ein kompatibles eindimensionales Array von MenuItem-Objekten, wobei am angegebenen Index des Zielarrays begonnen wird.Copies all the items from the MenuItemCollection object to a compatible one-dimensional array of MenuItem objects, starting at the specified index in the target array.

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)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Gibt einen Enumerator zurück, mit dem die Elemente im aktuellen MenuItemCollection-Objekt durchlaufen werden können.Returns an enumerator that can be used to iterate through the items in the current MenuItemCollection 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)
IndexOf(MenuItem) IndexOf(MenuItem) IndexOf(MenuItem) IndexOf(MenuItem)

Bestimmt den Index des angegebenen MenuItem-Objekts in der Auflistung.Determines the index of the specified MenuItem object in the collection.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
Remove(MenuItem) Remove(MenuItem) Remove(MenuItem) Remove(MenuItem)

Entfernt das angegebene MenuItem-Objekt aus dem MenuItemCollection-Objekt.Removes the specified MenuItem object from the MenuItemCollection object.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Entfernt das MenuItem-Objekt an der angegebenen Indexposition aus dem aktuellen MenuItemCollection-Objekt.Removes the MenuItem object at the specified index location from the current MenuItemCollection 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)

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

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

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Lädt den zuvor gespeicherten Ansichtszustand des MenuItemCollection-Objekts.Loads the MenuItemCollection object's previously saved view state.

IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Speichert die Änderungen am Ansichtszustand in einem Object.Saves the changes to view state to an Object.

IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

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

Extension Methods

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Konvertiert eine IEnumerable auf eine IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Siehe auch