CaptureCollection.IEnumerable<Capture>.GetEnumerator Methode

Definition

Namespace:

System.Text.RegularExpressions

Assembly:

System.Text.RegularExpressions.dll

Assembly:

netstandard.dll

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

 virtual System::Collections::Generic::IEnumerator<System::Text::RegularExpressions::Capture ^> ^ System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Capture>.GetEnumerator() = System::Collections::Generic::IEnumerable<System::Text::RegularExpressions::Capture ^>::GetEnumerator;

System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Capture> IEnumerable<Capture>.GetEnumerator ();

abstract member System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Capture>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Capture>
override this.System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Capture>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Capture>

Function GetEnumerator () As IEnumerator(Of Capture) Implements IEnumerable(Of Capture).GetEnumerator

Gibt zurück

IEnumerator<Capture>

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

Implementiert

GetEnumerator()

Hinweise

Die zurückgegebene IEnumerator<T> Eigenschaft bietet die Möglichkeit, durch die Auflistung zu iterieren, indem eine Current Eigenschaft angezeigt wird. Sie können Aufzählungen verwenden, um die Daten in einer Auflistung 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 Aufzählungsator auf das erste Element der Auflistung zu aktualisieren, bevor Der Wert Currentgelesen wird.
Current gibt das gleiche Objekt zurück, bis MoveNext es erneut als MoveNext Set Current auf das nächste Element 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. Hinzufügen, Ändern oder Löschen von Elementen, ist das Verhalten des Aufzählers nicht definiert.
Ein Aufzählerator hat keinen exklusiven Zugriff auf die Sammlung, sodass ein Aufzählerator weiterhin gültig bleibt, solange die Auflistung unverändert bleibt. Wenn Änderungen an der Auflistung vorgenommen werden, z. B. Hinzufügen, Ändern oder Löschen von Elementen, wird der Aufzählungsator ungültig und möglicherweise unerwartete Ergebnisse erhalten. Außerdem ist die Aufzählung einer Auflistung keine Thread-sichere Prozedur. Um die Threadsicherheit zu gewährleisten, sollten Sie die Auflistung während der Aufzählung sperren oder die Synchronisierung in der Auflistung implementieren.
Standardmäßige Implementierungen von Sammlungen im System.Collections.Generic Namespace werden nicht synchronisiert.