ConfigurationElementCollectionBase<T>.IEnumerable.GetEnumerator Method ()

IIS 7.0

Returns an enumerator that iterates through the collection.

Namespace:   Microsoft.Web.Administration
Assembly:  Microsoft.Web.Administration (in Microsoft.Web.Administration.dll)

IEnumerator IEnumerable.GetEnumerator()

Return Value

Type: System.Collections.IEnumerator

A System.Collections.IEnumerator interface that iterates through the collection.

Rather than directly manipulating the enumerator, you should use the C# foreach statement (for each in C++, For Each in Visual Basic), which hides the complexity of the enumerators.

An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated and its behavior is undefined.

Enumerating through a collection is intrinsically not a thread-safe procedure. Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions that result from changes made by other threads. To enable the collection to be accessed by multiple threads for reading and writing, you must implement your own synchronization.

For more information about using the enumerator, see the System.Collections.Generic.IEnumerator<T> interface.

Return to top