StringInfo.GetNextTextElement Método

  • Referência

Definição

Namespace:
System.Globalization
Assembly:
System.Globalization.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
mscorlib.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)

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 Text como uma unidade de texto que é exibida como um único caractere, ou seja, um grafemas. Um elemento de texto pode ser um caractere base, um par substituto ou uma sequência de caracteres de combinação. O padrão Unicode define um par substituto 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 combináveis. Um par substituto 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 Text 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)

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 Text como uma unidade de texto que é exibida como um único caractere, ou seja, um grafemas. Um elemento de texto pode ser um caractere base, um par substituto ou uma sequência de caracteres de combinação. O padrão Unicode define um par substituto 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 combináveis. Um par substituto 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 Text da cadeia de caracteres, o aplicativo deve usar o TextElementEnumerator gerado pelo GetTextElementEnumerator método.

Confira também

Aplica-se a