Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

QuaternionKeyFrameCollection.GetEnumerator méthode ()

 

Date de publication : novembre 2016

Retourne un énumérateur qui peut itérer au sein de la collection.

Espace de noms:   System.Windows.Media.Animation
Assembly:  PresentationCore (dans PresentationCore.dll)

public IEnumerator GetEnumerator()

Valeur de retour

Type: System.Collections.IEnumerator

IEnumerator qui peut itérer au sein de la collection.

Les énumérateurs permettent uniquement de lire les données dans la collection. Les énumérateurs ne peuvent pas être utilisés pour modifier la collection sous-jacente.

Au départ, l’énumérateur est positionné avant le premier élément dans la collection. Reset replace également l'énumérateur à cette position. À cette position, l'appel Current lève 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 retourne le même objet tant que MoveNext ou Reset n'est pas appelé. MoveNext définit Current vers l’élément suivant.

Après la fin de la collection est passée, l’énumérateur est positionné après le dernier élément dans la collection et l’appel MoveNext retourne false. Si le dernier appel à MoveNext retourné false, l’appel Current lève une exception. Pour définir Current sur le premier élément de la collection, vous pouvez appeler Reset suivie MoveNext.

Un énumérateur est valide tant que la collection demeure inchangée. Si des modifications sont apportées à la collection, telles que l’ajout, modification ou suppression d’éléments, l’énumérateur est définitivement invalidé et l’appel suivant à MoveNext ou Reset lève une InvalidOperationException. Si la collection est modifiée entre MoveNext et Current, Current renvoie l’élément auquel il est attribué, même si l’énumérateur est déjà invalidé.

Comme l'énumérateur ne dispose pas d'un accès exclusif à la collection, l'énumération d'une collection n'est pas intrinsèquement une procédure thread-safe. Même lorsqu’une collection est synchronisée, les autres threads peuvent toujours la modifier, ce qui amène l’énumérateur à lever une exception. Pour garantir la sécurité des threads au cours de l'énumération, vous pouvez verrouiller la collection pendant l'ensemble de l'énumération ou bien intercepter les exceptions résultant des modifications apportées par les autres threads.

.NET Framework
Disponible depuis 3.0
Retour au début
Afficher: