MenuItemCollection.GetEnumerator Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne un énumérateur qui peut être utilisé pour itérer au sein des éléments de l'objet MenuItemCollection en cours.
public:
virtual System::Collections::IEnumerator ^ GetEnumerator();public System.Collections.IEnumerator GetEnumerator ();abstract member GetEnumerator : unit -> System.Collections.IEnumerator
override this.GetEnumerator : unit -> System.Collections.IEnumeratorPublic Function GetEnumerator () As IEnumeratorRetours
Énumérateur qui peut être utilisé pour itérer au sein des éléments de l'objet MenuItemCollection en cours.
Implémente
Exemples
L’exemple de code suivant montre comment utiliser la GetEnumerator méthode pour créer un énumérateur qui contient les éléments de sous-menu de l’élément Music de menu dans un Menu contrôle.
<%@ 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)
{
// Display the submenu items of the Music
// menu item.
// Retrieve the Music menu item.
MenuItem musicMenuItem = NavigationMenu.FindItem(@"Home\Music");
// Use the GetEnumerator method to create an enumerator
// that contains the submenu items of the Music menu item.
IEnumerator menuItemEnumerator = musicMenuItem.ChildItems.GetEnumerator();
Message.Text = "The submenu items of the Music menu item are: <br/><br/>";
// Iterate though the enumerator to display the menu items.
while (menuItemEnumerator.MoveNext())
{
Message.Text += ((MenuItem)(menuItemEnumerator.Current)).Text + "<br />";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItemCollection GetEnumerator Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemCollection GetEnumerator 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>
<hr/>
<asp:label id="Message"
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 Page_Load(ByVal sender As Object, ByVal e As EventArgs)
' Display the submenu items of the Music
' menu item.
' Retrieve the Music menu item.
Dim musicMenuItem As MenuItem = NavigationMenu.FindItem("Home\Music")
' Use the GetEnumerator method to create an enumerator
' that contains the submenu items of the Music menu item.
Dim menuItemEnumerator As IEnumerator = musicMenuItem.ChildItems.GetEnumerator()
Message.Text = "The submenu items of the Music menu item are: <br/><br/>"
' Iterate though the enumerator to display the menu items.
While menuItemEnumerator.MoveNext()
Message.Text &= (CType(menuItemEnumerator.Current, MenuItem)).Text & "<br />"
End While
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItemCollection GetEnumerator Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemCollection GetEnumerator 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>
<hr/>
<asp:label id="Message"
runat="server"/>
</form>
</body>
</html>
Remarques
Utilisez la GetEnumerator méthode pour créer un énumérateur qui peut être facilement itéré pour obtenir chaque élément de l’objet actuel MenuItemCollection . Pour obtenir l’élément actuellement pointé dans l’énumérateur, utilisez la Current propriété. Utilisez la MoveNext méthode pour passer à l’élément suivant. Si vous devez replacer l’énumérateur au début de la collection, utilisez la Reset méthode.
Notes
Après avoir créé un énumérateur ou utilisé la Reset méthode, vous devez appeler la MoveNext méthode. Sinon, l’élément représenté par la Current propriété n’est pas défini.
Vous pouvez également utiliser la CopyTo méthode pour copier les éléments de la collection dans un tableau. Vous pouvez ensuite utiliser le tableau pour accéder aux éléments de la collection.