StringInfo.GetNextTextElement Método

Definición

Espacio de nombres:

System.Globalization

Ensamblado:

System.Runtime.dll

Obtiene el primer elemento de texto de una cadena especificada.

Sobrecargas

GetNextTextElement(String)	Obtiene el primer elemento de texto de una cadena especificada.
GetNextTextElement(String, Int32)	Obtiene el elemento de texto en el índice especificado de la cadena indicada.

GetNextTextElement(String)

Source:

StringInfo.cs

Obtiene el primer elemento de texto de una cadena especificada.

public:
 static System::String ^ GetNextTextElement(System::String ^ str);

public static string GetNextTextElement (string str);

static member GetNextTextElement : string -> string

Public Shared Function GetNextTextElement (str As String) As String

Parámetros

str

String

Cadena de la que se obtiene el elemento de texto.

Devoluciones

String

Cadena que contiene el primer elemento de texto de una cadena especificada.

Excepciones

ArgumentNullException

str es null.

Comentarios

.NET 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 una secuencia de caracteres combinada. El estándar Unicode 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 la segunda es un suplente bajo. El estándar Unicode define una secuencia de caracteres combinada 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 combinado.

Este método solo devuelve el primer elemento de texto. Para recorrer en iteración los elementos de texto de la cadena, la aplicación debe usar el TextElementEnumerator objeto generado por el GetTextElementEnumerator método .

Consulte también

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)

GetNextTextElement(String, Int32)

Source:

StringInfo.cs

Obtiene el elemento de texto en el índice especificado de la cadena indicada.

public:
 static System::String ^ GetNextTextElement(System::String ^ str, int index);

public static string GetNextTextElement (string str, int index);

static member GetNextTextElement : string * int -> string

Public Shared Function GetNextTextElement (str As String, index As Integer) As String

Parámetros

str

String

Cadena de la que se obtiene el elemento de texto.

index

Int32

Índice de base cero donde comienza el elemento de texto.

Devoluciones

String

Cadena que contiene el elemento de texto en el índice especificado de la cadena indicada.

Excepciones

ArgumentNullException

str es null.

ArgumentOutOfRangeException

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

Comentarios

.NET 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 una secuencia de caracteres combinada. El estándar Unicode 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 la segunda es un suplente bajo. El estándar Unicode define una secuencia de caracteres combinada 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 combinado.

Este método solo devuelve el primer elemento de texto de la subcadena que comienza en el índice especificado. Para recorrer en iteración los elementos de texto de la cadena, la aplicación debe usar el TextElementEnumerator generado por el GetTextElementEnumerator método .

Consulte también

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)