MatchCollection.IEnumerable<Match>.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.
virtual System::Collections::Generic::IEnumerator<System::Text::RegularExpressions::Match ^> ^ System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator() = System::Collections::Generic::IEnumerable<System::Text::RegularExpressions::Match ^>::GetEnumerator;System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match> IEnumerable<Match>.GetEnumerator ();abstract member System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>
override this.System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>Function GetEnumerator () As IEnumerator(Of Match) Implements IEnumerable(Of Match).GetEnumeratorRetours
Énumérateur permettant d'effectuer une itération au sein de la collection.
Implémente
Exceptions
La collection est en lecture seule.
Remarques
Le retourné IEnumerator<T> offre la possibilité d’itérer dans la collection en exposant une Current propriété . Vous pouvez utiliser des énumérateurs pour lire les données d’une collection, mais pas pour modifier la collection.
Au départ, l'énumérateur est positionné avant le premier élément de la collection. À cette position, Current n'est pas défini. Par conséquent, vous devez appeler la MoveNext méthode pour faire avancer l’énumérateur vers le premier élément de la collection avant de lire la valeur de Current.
Current retourne le même objet jusqu’à ce qu’il MoveNext soit appelé à nouveau en tant que MoveNext jeux Current de l’élément suivant.
Si MoveNext passe la fin de la collection, l’énumérateur est positionné après le dernier élément de la collection et MoveNext retourne false. Lorsque l’énumérateur se trouve à cette position, les appels suivants pour MoveNext retourner falseégalement . Si le dernier appel à MoveNext retourné false, Current n’est pas défini. Vous ne pouvez pas attribuer de nouveau Current au premier élément de la collection ; vous devez créer une nouvelle instance de l’énumérateur à la place. Si des modifications sont apportées à la collection, telles que l’ajout, la modification ou la suppression d’éléments, le comportement de l’énumérateur n’est pas défini.
Un énumérateur n’ayant pas un accès exclusif à la collection, un énumérateur reste valide tant que la collection reste inchangée. Si des modifications sont apportées à la collection, telles que l’ajout, la modification ou la suppression d’éléments, l’énumérateur est invalidé et vous pouvez obtenir des résultats inattendus. En outre, l’énumération d’une collection n’est pas une procédure thread-safe. Pour garantir la sécurité des threads, vous devez verrouiller la collection pendant l’énumérateur ou implémenter la synchronisation sur la collection.
Les implémentations par défaut des collections dans l’espace System.Collections.Generic de noms ne sont pas synchronisées.
