CharEnumerator (Clase)
Ensamblado: mscorlib (en 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
Un CharEnumerator proporciona acceso de sólo lectura a los caracteres de un objeto String al que se hace referencia. Por ejemplo, la instrucción foreach de los lenguajes de programación Microsoft Visual Basic y C#, que recorre en iteración los elementos de una colección, recupera un objeto CharEnumerator de un objetoString para recorrer en iteración los caracteres de ese objeto.
No hay ningún constructor público para CharEnumerator. En su lugar, llame al método GetEnumerator de un objeto String para obtener un CharEnumerator que se inicialice para hacer referencia a la cadena.
Un CharEnumerator mantiene un índice interno a los caracteres de la cadena a que hace referencia el CharEnumerator. El estado del índice no es válido cuando hace referencia a una posición de carácter situada lógicamente delante del primer carácter o detrás del último carácter de la cadena, y es válido cuando hace referencia a un carácter situado dentro de la cadena. El índice se inicializa en una posición situada lógicamente delante del primer carácter, y se establece en una posición situada detrás del último carácter cuando finaliza la iteración. Se produce una excepción si se intenta el acceso a un carácter cuando el índice no es válido.
El método MoveNext incrementa el índice en una unidad, de modo que el acceso al primer carácter y a los caracteres siguientes se produce secuencialmente. El método Reset establece el índice en una posición situada lógicamente delante del primer carácter. La propiedad Current recupera el carácter al que hace referencia actualmente el índice. El método Clone crea una copia del CharEnumerator.
 Nota |
|---|
| Varias instancias independientes de CharEnumerator en uno o varios subprocesos pueden tener acceso a una sola instancia de String. Esta clase se implementa para admitir la interfaz IEnumerator. Para obtener más información sobre el uso de un enumerador, vea el tema IEnumerator. |
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
