MatchCollection.IEnumerable<Match>.GetEnumerator Methode

Definition

Namespace:

System.Text.RegularExpressions

Assembly:

System.Text.RegularExpressions.dll

Quelle:

MatchCollection.cs

Gibt einen Enumerator zurück, der die Auflistung durchläuft.

 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

Gibt zurück

IEnumerator<Match>

Ein Enumerator, der zum Durchlaufen der Auflistung verwendet werden kann.

Implementiert

GetEnumerator()

Ausnahmen

NotSupportedException

Die Auflistung ist schreibgeschützt.

Hinweise

Das zurückgegebene IEnumerator<T> bietet die Möglichkeit, die Auflistung zu durchlaufen, indem eine Current -Eigenschaft verfügbar ist. Sie können Enumeratoren verwenden, um die Daten in einer Sammlung zu lesen, aber nicht, um die Auflistung zu ändern. Zu Beginn wird der Enumerator vor das erste Element in der Auflistung positioniert. An dieser Position ist Current nicht definiert. Daher müssen Sie die MoveNext -Methode aufrufen, um den Enumerator auf das erste Element der Auflistung vor dem Lesen des Werts von Currentzu weiterentwickeln. Current gibt dasselbe -Objekt zurück, bis MoveNext erneut als MoveNext auf das nächste Element festgelegt Current aufgerufen wird. Wenn MoveNext das Ende der Auflistung übergibt, wird der Enumerator hinter dem letzten Element in der Auflistung platziert, und MoveNext gibt false zurück. Wenn sich der Enumerator an dieser Position befindet, geben nachfolgende Aufrufe von MoveNext auch false zurück. Wenn der letzte Aufruf MoveNext zurückgegebene false, Current ist nicht definiert. Sie können Current nicht erneut auf das erste Element der Auflistung festlegen, sondern müssen eine neue Enumeratorinstanz erstellen. Wenn Änderungen an der Auflistung vorgenommen werden, z. B. das Hinzufügen, Ändern oder Löschen von Elementen, ist das Verhalten des Enumerators undefiniert. Ein Enumerator hat keinen exklusiven Zugriff auf die Auflistung, sodass ein Enumerator gültig bleibt, solange die Auflistung unverändert bleibt. Wenn Änderungen an der Auflistung vorgenommen werden, z. B. das Hinzufügen, Ändern oder Löschen von Elementen, wird der Enumerator ungültig, und Sie erhalten möglicherweise unerwartete Ergebnisse. Außerdem ist das Aufzählen einer Sammlung keine threadsichere Prozedur. Um die Threadsicherheit zu gewährleisten, sollten Sie die Sammlung während des Enumerators sperren oder die Synchronisierung für die Sammlung implementieren. Standardimplementierungen von Auflistungen im System.Collections.Generic Namespace werden nicht synchronisiert.