Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método StringInfo.GetTextElementEnumerator (String, Int32)

 

Publicado: octubre de 2016

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
Type: System.String

La cadena para recorrer en iteración.

index
Type: System.Int32

Índice de base cero en el que se inicie la iteración.

Valor devuelto

Type: System.Globalization.TextElementEnumerator

Un TextElementEnumerator para la cadena a partir de index.

Exception Condition
ArgumentNullException

El valor de str es null.

ArgumentOutOfRangeException

index está fuera del intervalo de índices válidos para la str.

.NET Framework define un elemento de texto como una 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 un carácter combinable secuencia. El Unicode Standard define un par suplente como una representación de caracteres codificados para un único carácter abstracto que consta de una secuencia de dos unidades de código, donde la primera unidad del par es un suplente alto y el segundo es un suplente bajo. El estándar Unicode define una combinación secuencia como una combinación de un carácter base y uno o más caracteres de combinación de caracteres. 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 de la cadena; no puede modificar la cadena subyacente. El enumerador no tiene acceso exclusivo a la cadena.

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

Inicialmente, el enumerador se coloca antes del primer elemento de texto en la cadena. Reset también devuelve el enumerador a esta posición. Por lo tanto, después de crea un enumerador o después de Reset se llama, MoveNext debe llamarse para adelantar 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.

Cuando se pasa el final de la cadena, el enumerador vuelve a estar en un estado no válido y que realiza la llamada MoveNext devuelve false. Llamar a Current produce una excepción si la última llamada a MoveNext devuelve false.

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: