Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

StringInfo.GetTextElementEnumerator (Método) (String, Int32)

Devuelve un enumerador que recorre en iteración los elementos de texto de la cadena, empezando en el índice especificado.

Espacio de nombres:  System.Globalization
Ensamblado:  mscorlib (en mscorlib.dll)

public static TextElementEnumerator GetTextElementEnumerator(
	string str,
	int index
)

Parámetros

str
Tipo: System.String
La cadena que se va a recorrer en iteración.
index
Tipo: System.Int32
Índice de base cero donde comienza la iteración.

Valor devuelto

Tipo: System.Globalization.TextElementEnumerator
TextElementEnumerator para la cadena empezando en index.

ExcepciónCondición
ArgumentNullException

str es null.

ArgumentOutOfRangeException

El valor de index se encuentra fuera del intervalo de índices válidos para str.

En .NET Framework se define un elemento de texto como unidad de texto que se muestra como un solo carácter, es decir, un grafema. Un elemento de texto puede ser un carácter base, un par suplente o una secuencia de caracteres de combinación. El estándar Unicodehttp://go.microsoft.com/fwlink/?linkid=37123define un par suplente como representación codificada de caracteres para un único carácter abstracto que consta de una secuencia de dos unidades de código, en el que la primera unidad del par es un suplente alto y la segunda un suplente bajo. El estándar Unicode define una secuencia de caracteres de combinación como una combinación de un carácter base y uno o varios caracteres combinados. Un par suplente puede representar un carácter base o un carácter combinable.

El enumerador de elemento de texto sólo se utiliza para leer los datos en la cadena; no puede modificar la cadena subyacente. El enumerador no posee acceso exclusivo a la cadena.

El enumerador se encuentra en un estado no válido si se coloca antes del primer elemento de texto de la cadena o después del último. Cuando el enumerador se encuentra en un estado no válido, cualquier llamada a Current produce una excepción.

Inicialmente, el enumerador se coloca antes del primer elemento de texto de la cadena. Reset también devuelve el enumerador a esta posición. Por tanto, después de la creación de un enumerador o después de llamar a Reset, se debe llamar a MoveNext para hacer avanzar el enumerador hasta el primer elemento de texto de la cadena antes de leer el valor de Current.

Current devuelve el mismo objeto hasta que se llama a MoveNext o a Reset.

Una vez alcanzado el final de la cadena, el enumerador regresa a un estado no válido y, si se llama a MoveNext, devuelve false. Al llamar a Current se produce una excepción si la última llamada a MoveNext devolvió false.

.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft