IDTSPathCollection100.GetEnumerator Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
public:
System::Collections::IEnumerator ^ GetEnumerator();[System.Runtime.InteropServices.DispId(-4)]
public System.Collections.IEnumerator GetEnumerator();[<System.Runtime.InteropServices.DispId(-4)>]
abstract member GetEnumerator : unit -> System.Collections.IEnumeratorPublic Function GetEnumerator () As IEnumeratorRetours
Retourne un numérateur IE utilisé pour itérer la collection.
Implémente
- Attributs
Remarques
Les énumérateurs autorisent uniquement la lecture des données dans la collection. Les énumérateurs ne peuvent pas être utilisés pour modifier la collection sous-jacente.
Initialement, l’énumérateur est positionné avant le premier élément de la collection. La réinitialisation ramène également l’énumérateur à cette position. À cette position, appeler Courant lance une exception. Par conséquent, vous devez appeler MoveNext pour avancer l’énumérateur au premier élément de la collection avant de lire la valeur de Current.
Current renvoie le même objet jusqu’à ce que MoveNext ou Reset soit appelé soit Set . MoveNext fixe Current sur l’élément suivant.
Après la fin de la collection, l’énumérateur est positionné après le dernier élément de la collection, et appeler MoveNextrestitue un faux élément. Si le dernier appel à MoveNext est revenu faux, appeler Current lance une exception. Pour redéfinir Current comme premier élément de la collection, vous pouvez appeler Reset suivi de MoveNext.
Un énumérateur reste valide tant que la collection reste inchangée. Si des modifications sont apportées à la collection, comme l’ajout, la modification ou la suppression d’éléments, l’énumérateur est irrémédiablement invalidé et l’appel suivant à MoveNext ou Reset génère une InvalidOperationException. Si la collection est modifiée entre MoveNext et Current, Current renvoie l’élément auquel elle est assignée, même si l’énumérateur est déjà invalidé.
L’énumérateur n’a pas d’accès exclusif à la collection ; par conséquent, l’énumération par le biais d’une collection n’est pas intrinsèquement une procédure thread-safe. Même lorsqu’une collection est synchronisée, d’autres threads peuvent toujours modifier la collection, ce qui provoque 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 résultant des modifications apportées par d’autres threads.