ConfigurationElementCollectionBase<T>.IEnumerable.GetEnumerator Methode

Definition

Namespace:

Microsoft.Web.Administration

Assembly:

Microsoft.Web.Administration.dll

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

 virtual System::Collections::IEnumerator ^ System.Collections.IEnumerable.GetEnumerator() = System::Collections::IEnumerable::GetEnumerator;

System.Collections.IEnumerator IEnumerable.GetEnumerator ();

Function GetEnumerator () As IEnumerator Implements IEnumerable.GetEnumerator

Gibt zurück

IEnumerator

Eine IEnumerator Schnittstelle, die die Auflistung durchläuft.

Implementiert

GetEnumerator()

Hinweise

Anstatt den Enumerator direkt zu manipulieren, sollten Sie die C#- foreach Anweisung (for each in C++, in Visual Basic) verwenden, For Each die die Komplexität der Enumeratoren ausblendet.

Ein Enumerator bleibt gültig, solange die Auflistung unverändert bleibt. Werden an der Auflistung Änderungen wie z. B. Hinzufügen, Bearbeiten oder Entfernen von Elementen vorgenommen, verliert der Enumerator unwiederbringlich seine Gültigkeit und sein Verhalten ist nicht definiert.

Die Enumeration einer Auflistung ist systemintern keine threadsichere Prozedur. Selbst wenn eine Auflistung synchronisiert wird, besteht die Möglichkeit, dass andere Threads sie ändern. Dies führt dazu, dass der Enumerator eine Ausnahme auslöst. Um die Threadsicherheit während der Enumeration zu gewährleisten, können Sie entweder die Auflistung während der gesamten Enumeration sperren oder die Ausnahmen abfangen, die sich aus Änderungen ergeben, die von anderen Threads vorgenommen wurden. Damit mehrere Threads zum Lesen und Schreiben auf die Sammlung zugreifen können, müssen Sie eine eigene Synchronisierung implementieren.

Weitere Informationen zur Verwendung des Enumerators finden Sie in der System.Collections.Generic.IEnumerator<T> Schnittstelle.