MatchCollection.IEnumerable<Match>.GetEnumerator Méthode

Définition

Espace de noms:

System.Text.RegularExpressions

Assembly:

System.Text.RegularExpressions.dll

Source:

MatchCollection.cs

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).GetEnumerator

Retours

IEnumerator<Match>

Énumérateur permettant d'effectuer une itération au sein de la collection.

Implémente

GetEnumerator()

Exceptions

NotSupportedException

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.