Partager via


Collection.GetEnumerator Méthode

Définition

Retourne un énumérateur qui itère au sein de la collection.

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 permettant d'effectuer une itération au sein de 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 MoveNext méthodes et Reset . Pour plus d’informations, consultez Instruction For Each...Next.

Remarques

Pour chaque... Next Statement 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 proche de l’itération que les For Eachinstructions ...Next , 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 souhaiterez peut-être 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 énumérateur, car le précédent est invalidé.

S’applique à