Collection.GetEnumerator Méthode

public:
 System::Collections::IEnumerator ^ GetEnumerator();

public System.Collections.IEnumerator GetEnumerator();

member this.GetEnumerator : unit -> System.Collections.IEnumerator

Public Function GetEnumerator () As IEnumerator

Retours

Énumérateur qui peut être utilisé pour itérer dans la collection.

Exemples

L’exemple suivant montre comment utiliser GetEnumerator pour récupérer tous les éléments d’un Collection objet.

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 System.Collections de noms. L’objet énumérateur expose la Current propriété et les MoveNextReset méthodes. Pour plus d’informations, consultez Instruction For Each...Next.

Remarques

Le for each... L’instruction suivante 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 For Eachboucle ...Next pour parcourir une collection ou un tableau, et vous n’avez pas besoin d’appeler GetEnumerator explicitement.

Si vous avez besoin d’un contrôle plus étroit sur l’itération que les For Eachinstructions ...Next fournissent, vous pouvez utiliser la GetEnumerator méthode pour effectuer une traversée personnalisée. Voici quelques cas dans lesquels vous devrez peut-être effectuer cette opération.

• Vous pouvez revenir au début de la collection et recommencer l’itération avant qu’elle ne soit terminée.

• Vous pouvez ignorer un ou plusieurs éléments pour diverses raisons.

• Vous devrez peut-être modifier les éléments de la collection au milieu d’une traversée. Dans ce cas, vous devez obtenir un nouvel objet d’énumérateur, car le précédent n’est pas valide.