Compartilhar via


StringInfo.GetNextTextElement Método

Definição

Obtém o primeiro elemento de texto de uma cadeia de caracteres especificada.

Sobrecargas

GetNextTextElement(String)

Obtém o primeiro elemento de texto de uma cadeia de caracteres especificada.

GetNextTextElement(String, Int32)

Obtém o elemento de texto no índice especificado da cadeia de caracteres especificada.

GetNextTextElement(String)

Origem:
StringInfo.cs
Origem:
StringInfo.cs
Origem:
StringInfo.cs

Obtém o primeiro elemento de texto de uma cadeia de caracteres 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

A cadeia de caracteres da qual o elemento de texto será obtido.

Retornos

Uma cadeia de caracteres que contém o primeiro elemento de texto da cadeia de caracteres especificada.

Exceções

str é null.

Comentários

O .NET define um elemento de texto como uma unidade de texto que é exibida como um único caractere, ou seja, um grafeme. Um elemento de texto pode ser um caractere base, um par alternativo ou uma sequência de caracteres de combinação. O Padrão Unicode define um par alternativo como uma representação de caractere codificado para um único caractere abstrato que consiste em uma sequência de duas unidades de código, em que a primeira unidade do par é um substituto alto e o segundo é um substituto baixo. O Padrão Unicode define uma sequência de caracteres de combinação como uma combinação de um caractere base e um ou mais caracteres de combinação. Um par alternativo pode representar um caractere base ou um caractere de combinação.

Esse método retorna apenas o primeiro elemento de texto. Para iterar pelos elementos de texto da cadeia de caracteres, o aplicativo deve usar o TextElementEnumerator objeto gerado pelo GetTextElementEnumerator método .

Confira também

Aplica-se a

GetNextTextElement(String, Int32)

Origem:
StringInfo.cs
Origem:
StringInfo.cs
Origem:
StringInfo.cs

Obtém o elemento de texto no índice especificado da cadeia de caracteres especificada.

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

A cadeia de caracteres da qual o elemento de texto será obtido.

index
Int32

O índice baseado em zero no qual é iniciado o elemento de texto.

Retornos

Uma cadeia de caracteres que contém o elemento de texto no índice especificado da cadeia de caracteres especificada.

Exceções

str é null.

index está fora do intervalo de índices válidos para str.

Comentários

O .NET define um elemento de texto como uma unidade de texto que é exibida como um único caractere, ou seja, um grafeme. Um elemento de texto pode ser um caractere base, um par alternativo ou uma sequência de caracteres de combinação. O Padrão Unicode define um par alternativo como uma representação de caractere codificado para um único caractere abstrato que consiste em uma sequência de duas unidades de código, em que a primeira unidade do par é um substituto alto e o segundo é um substituto baixo. O Padrão Unicode define uma sequência de caracteres de combinação como uma combinação de um caractere base e um ou mais caracteres de combinação. Um par alternativo pode representar um caractere base ou um caractere de combinação.

Esse método retorna apenas o primeiro elemento de texto da subcadeia de caracteres que começa no índice especificado. Para iterar pelos elementos de texto da cadeia de caracteres, o aplicativo deve usar o TextElementEnumerator gerado pelo GetTextElementEnumerator método .

Confira também

Aplica-se a