GetEnumerator, méthode (objet Collection)
Mise à jour : novembre 2007
Retourne une référence à un objet énumérateur utilisé pour parcourir un Collection, objet (Visual Basic).
Public Function GetEnumerator() As IEnumerator
Notes
For Each...Next, instruction (Visual Basic) appelle GetEnumerator pour obtenir un objet énumérateur pour prendre en charge l'itération sur les éléments d'une collection. Normalement, vous utilisez une boucle For Each...Next pour parcourir une collection ou un tableau sans devoir appeler GetEnumerator explicitement.
Si vous avez besoin de contrôle plus précis sur l'itération que celui fourni par les instructions For Each...Next, vous pouvez utiliser la méthode GetEnumerator pour exécuter un parcours personnalisé. Voici quelques cas pour lesquels vous serez susceptible de devoir utiliser cette méthode.
Il est possible de retourner au début de la collection et de redémarrer l'itération avant qu'elle ne soit terminée.
Vous est susceptible de vouloir ignorer un ou plusieurs éléments pour diverses raisons.
Vous est susceptible de devoir modifier les éléments de la collection en plein milieu d'un parcours. Dans ce cas, vous devez obtenir un nouvel objet énumérateur, car le précédent n'est plus valable.
Exemple
L'exemple suivant montre comment utiliser GetEnumerator pour récupérer un élément de l'objet Collection.
Dim customers As New Collection
' Insert code to add elements to the customers collection.
Dim custEnum As IEnumerator = customers.GetEnumerator()
custEnum.Reset()
Dim thisCustomer As Object
While custEnum.MoveNext()
thisCustomer = custEnum.Current()
' Insert code to process this element of the collection.
End While
GetEnumerator construit et retourne un objet énumérateur qui implémente l'interface IEnumerator de l'espace de noms System.Collections. L'objet énumérateur expose la propriété Current et les méthodes MoveNext et Reset. Pour plus d'informations, consultez For Each...Next, instruction (Visual Basic).
Configuration requise
Espace de noms :Microsoft.VisualBasic
**Module :**Collection
**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)