Dictionary<TKey,TValue>.KeyCollection.GetEnumerator Methode

Definition

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Quelle:

Dictionary.cs

Gibt einen Enumerator zurück, der die Dictionary<TKey,TValue>.KeyCollection durchläuft.

public:
 System::Collections::Generic::Dictionary<TKey, TValue>::KeyCollection::Enumerator GetEnumerator();

public System.Collections.Generic.Dictionary<TKey,TValue>.KeyCollection.Enumerator GetEnumerator ();

member this.GetEnumerator : unit -> System.Collections.Generic.Dictionary<'Key, 'Value>.KeyCollection.Enumerator

Public Function GetEnumerator () As Dictionary(Of TKey, TValue).KeyCollection.Enumerator

Gibt zurück

Dictionary<TKey,TValue>.KeyCollection.Enumerator

Ein Dictionary<TKey,TValue>.KeyCollection.Enumerator für die Dictionary<TKey,TValue>.KeyCollection.

Hinweise

Die foreach Anweisung der C#-Sprache (for each in C++, For Each in Visual Basic) blendet die Komplexität der Enumeratoren aus. Daher empfiehlt es sich, foreach zu verwenden und den Enumerator nicht direkt zu ändern.

Mit Enumeratoren können die Daten in der Auflistung zwar gelesen, jedoch nicht zum Ändern der zugrunde liegenden Auflistung verwendet werden.

Zu Beginn wird der Enumerator vor das erste Element in der Auflistung positioniert. An dieser Position ist Current nicht definiert. Sie müssen aufrufen MoveNext , um den Enumerator auf das erste Element der Auflistung zu weiterentwickeln, bevor Sie den Wert von Currentlesen.

Current gibt solange dasselbe Objekt zurück, bis MoveNext aufgerufen wird. MoveNext legt Current auf das nächste Element fest.

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.

Ein Enumerator bleibt gültig, solange die Auflistung unverändert bleibt. Wenn Änderungen an der Auflistung vorgenommen werden, z. B. das Hinzufügen von Elementen oder das Ändern der Kapazität, wird der Enumerator unwiederbringlich ungültig, und der nächste Aufruf MoveNext oder IEnumerator.Reset löst einen aus InvalidOperationException.

Nur .NET Core 3.0 und höher: Die einzigen mutierenden Methoden, die Enumeratoren nicht ungültig machen, sind Remove und Clear.

Der Enumerator hat keinen exklusiven Zugriff auf die Auflistung; daher ist die Enumeration einer Auflistung systembedingt kein threadsicheres Verfahren. Um während der Enumeration Threadsicherheit zu garantieren, können Sie die Auflistung während der gesamten Enumeration sperren. Um den Lese- und Schreibzugriff auf diese Auflistung durch mehrere Threads zuzulassen, müssen Sie eine eigene Synchronisierung implementieren.

Standardimplementierungen von Sammlungen in System.Collections.Generic werden nicht synchronisiert.

Diese Methode ist ein O(1)-Vorgang.

Weitere Informationen

• Dictionary<TKey,TValue>.KeyCollection.Enumerator
• IEnumerator<T>