IEnumeratorContract<T> Interface
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.
Énumère les éléments dans une collection IListContract<T>.
generic <typename T>
public interface class IEnumeratorContract : IDisposable
public interface IEnumeratorContract<T> : IDisposable
type IEnumeratorContract<'T> = interface
interface IDisposable
Public Interface IEnumeratorContract(Of T)
Implements IDisposable
Paramètres de type
- T
Type des objets en cours d'énumération.
- Implémente
Remarques
Les énumérateurs peuvent être utilisés pour lire les données de la collection, mais ils ne peuvent pas être utilisés pour modifier la collection.
Au départ, l'énumérateur est positionné avant le premier élément de la collection. À cette position, la valeur de retour de n’est GetCurrent pas définie. Par conséquent, vous devez appeler MoveNext pour faire avancer l’énumérateur vers le premier élément de la collection avant d’appeler GetCurrent.
GetCurrent retourne le même objet jusqu'à ce que MoveNext soit appelé. MoveNext définit la valeur de retour de GetCurrent à l’élément suivant.
Si MoveNext passe la fin de la collection, l’énumérateur est positionné après le dernier élément de la collection et MoveNext retourne false
. Lorsque l’énumérateur se trouve à cette position, les appels suivants pour MoveNext retourner false
également . Si le dernier appel à MoveNext retourné false
, la valeur de retour de n’est GetCurrent pas définie.
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.
Méthodes
Dispose() |
Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées. (Hérité de IDisposable) |
GetCurrent() |
Retourne les objets dans la collection à la position actuelle de l'énumérateur. |
MoveNext() |
Avance l’énumérateur à l’élément suivant de la collection. |
Reset() |
Rétablit l’énumérateur à sa position initiale, qui précède le premier élément de la collection. |