MatchCollection.IEnumerable<Match>.GetEnumerator Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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).GetEnumeratorGibt zurück
Ein Enumerator, der zum Durchlaufen der Auflistung verwendet werden kann.
Implementiert
Ausnahmen
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.
