CharEnumerator, classe
Assembly : mscorlib (dans mscorlib.dll)
[SerializableAttribute] [ComVisibleAttribute(true)] public sealed class CharEnumerator : ICloneable, IEnumerator<char>, IDisposable, IEnumerator
/** @attribute SerializableAttribute() */ /** @attribute ComVisibleAttribute(true) */ public final class CharEnumerator implements ICloneable, IEnumerator<char>, IDisposable, IEnumerator
SerializableAttribute ComVisibleAttribute(true) public final class CharEnumerator implements ICloneable, IEnumerator<char>, IDisposable, IEnumerator
CharEnumerator fournit un accès en lecture seule aux caractères figurant dans un objet String référencé. Par exemple, l'instruction foreach des langages de programmation Microsoft Visual Basic et C#, qui parcourt les éléments d'une collection, récupère CharEnumerator d'un objet de String afin de parcourir les caractères figurant dans cet objet.
Il n'existe pas de constructeur public pour CharEnumerator. Appelez plutôt la méthode GetEnumerator d'un objet String pour obtenir un CharEnumerator qui est initialisé pour référencer la chaîne.
CharEnumerator gère un index interne pour les caractères figurant dans la chaîne référencée par CharEnumerator. L'état de l'index est non valide lorsqu'il référence logiquement une position de caractère avant le premier caractère ou après le dernier caractère de la chaîne et il est valide lorsqu'il référence un caractère figurant dans la chaîne. L'index est logiquement initialisé à une position figurant avant le premier caractère et est affecté à une position située après le dernier caractère lorsque le parcours est terminé. Une exception est levée lorsque vous tentez d'accéder à un caractère tandis que l'index est non valide.
La méthode MoveNext incrémente l'index d'une unité, de sorte que le premier caractère et le caractère suivant soient accédés alternativement. La méthode Reset affecte logiquement une position à l'index avant le premier caractère. La propriété Current récupère le caractère actuellement référencé par l'index. La méthode Clone crée une copie de CharEnumerator.
Remarque |
|---|
| Plusieurs instances indépendantes de CharEnumerator sur un ou plusieurs threads peuvent accéder à une seule instance de String. Cette classe est implémentée pour prendre en charge l'interface IEnumerator. Pour plus d'informations sur l'utilisation d'un énumérateur, consultez la rubrique IEnumerator. |
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
Remarque