StringInfo.GetNextTextElement StringInfo.GetNextTextElement StringInfo.GetNextTextElement StringInfo.GetNextTextElement Method

Definición

Obtiene el primer elemento de texto de una cadena especificada.Gets the first text element in a specified string.

Sobrecargas

GetNextTextElement(String) GetNextTextElement(String) GetNextTextElement(String) GetNextTextElement(String)

Obtiene el primer elemento de texto de una cadena especificada.Gets the first text element in a specified string.

GetNextTextElement(String, Int32) GetNextTextElement(String, Int32) GetNextTextElement(String, Int32) GetNextTextElement(String, Int32)

Obtiene el elemento de texto en el índice especificado de la cadena indicada.Gets the text element at the specified index of the specified string.

GetNextTextElement(String) GetNextTextElement(String) GetNextTextElement(String) GetNextTextElement(String)

Obtiene el primer elemento de texto de una cadena especificada.Gets the first text element in a specified string.

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 String String String

Cadena de la que se obtiene el elemento de texto.The string from which to get the text element.

Devoluciones

Cadena que contiene el primer elemento de texto de una cadena especificada.A string containing the first text element in the specified string.

Excepciones

Comentarios

.NET define un elemento de texto como una unidad de texto que se muestra como un carácter único, es decir, un grafemas..NET defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. Un elemento de texto puede ser un carácter base, un par suplente o un carácter combinable secuencia.A text element can be a base character, a surrogate pair, or a combining character sequence. 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 el segundo es bajo suplente.The Unicode Standard defines a surrogate pair as a coded character representation for a single abstract character that consists of a sequence of two code units, where the first unit of the pair is a high surrogate and the second is a low surrogate. 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.The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. Un par suplente puede representar un carácter base o un carácter de combinación.A surrogate pair can represent a base character or a combining character.

Este método sólo devuelve el primer elemento de texto.This method only returns the first text element. Para recorrer en iteración los elementos de la cadena de texto, la aplicación debe utilizar el TextElementEnumerator objeto generado por el GetTextElementEnumerator método.To iterate through the text elements of the string, the application should use the TextElementEnumerator object generated by the GetTextElementEnumerator method.

Consulte también:

GetNextTextElement(String, Int32) GetNextTextElement(String, Int32) GetNextTextElement(String, Int32) GetNextTextElement(String, Int32)

Obtiene el elemento de texto en el índice especificado de la cadena indicada.Gets the text element at the specified index of the specified string.

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 String String String

Cadena de la que se obtiene el elemento de texto.The string from which to get the text element.

index
Int32 Int32 Int32 Int32

Índice de base cero donde comienza el elemento de texto.The zero-based index at which the text element starts.

Devoluciones

Cadena que contiene el elemento de texto en el índice especificado de la cadena indicada.A string containing the text element at the specified index of the specified string.

Excepciones

index está fuera del intervalo de índices válidos para la str.index is outside the range of valid indexes for str.

Comentarios

.NET define un elemento de texto como una unidad de texto que se muestra como un carácter único, es decir, un grafemas..NET defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. Un elemento de texto puede ser un carácter base, un par suplente o un carácter combinable secuencia.A text element can be a base character, a surrogate pair, or a combining character sequence. 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 el segundo es bajo suplente.The Unicode Standard defines a surrogate pair as a coded character representation for a single abstract character that consists of a sequence of two code units, where the first unit of the pair is a high surrogate and the second is a low surrogate. 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.The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. Un par suplente puede representar un carácter base o un carácter de combinación.A surrogate pair can represent a base character or a combining character.

Este método sólo devuelve el primer elemento de texto de la subcadena que empieza en el índice especificado.This method only returns the first text element of the substring that starts at the specified index. Para recorrer en iteración los elementos de la cadena de texto, la aplicación debe utilizar el TextElementEnumerator generados por el GetTextElementEnumerator método.To iterate through the text elements of the string, the application should use the TextElementEnumerator generated by the GetTextElementEnumerator method.

Consulte también:

Se aplica a