StringInfo.GetNextTextElement Método

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

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

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

String

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

Exceções

ArgumentNullException

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

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)

GetNextTextElement(String, Int32)

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

String

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

Exceções

ArgumentNullException

str é null.

ArgumentOutOfRangeException

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

• GetTextElementEnumerator(String)
• ParseCombiningCharacters(String)