Collection.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 itère au sein de la collection.
public:
System::Collections::IEnumerator ^ GetEnumerator();public System.Collections.IEnumerator GetEnumerator ();member this.GetEnumerator : unit -> System.Collections.IEnumeratorPublic Function GetEnumerator () As IEnumeratorRetours
É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é.
