ConfigurationElementCollectionBase<T>.IEnumerable.GetEnumerator Méthode

Définition

Espace de noms:

Microsoft.Web.Administration

Assembly:

Microsoft.Web.Administration.dll

Retourne un énumérateur qui itère au sein de la collection.

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

System.Collections.IEnumerator IEnumerable.GetEnumerator ();

Function GetEnumerator () As IEnumerator Implements IEnumerable.GetEnumerator

Retours

IEnumerator

Interface IEnumerator qui itère dans la collection.

Implémente

GetEnumerator()

Remarques

Plutôt que de manipuler directement l’énumérateur, vous devez utiliser l’instruction C# foreach (for each en C++, For Each en Visual Basic), qui masque la complexité des énumérateurs.

Un énumérateur reste valide aussi longtemps que la collection demeure inchangée. Si des modifications sont apportées à la collection, telles que l’ajout, la modification ou la suppression d’éléments, l’énumérateur est définitivement invalidé et son comportement n’est pas défini.

L'énumération d'une collection n'est intrinsèquement pas une procédure thread-safe. Même lorsqu'une collection est synchronisée, les autres threads peuvent toujours la modifier, ce qui entraîne la levée d'une exception par l'énumérateur. Pour garantir la sécurité des threads pendant l’énumération, vous pouvez verrouiller la collection pendant toute l’énumération ou intercepter les exceptions qui résultent des modifications apportées par d’autres threads. Pour permettre à la collection d’accéder à plusieurs threads pour la lecture et l’écriture, vous devez implémenter votre propre synchronisation.

Pour plus d’informations sur l’utilisation de l’énumérateur, consultez l’interface System.Collections.Generic.IEnumerator<T> .