StringInfo.GetNextTextElement Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> stringPublic Shared Function GetNextTextElement (str As String) As StringParâ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 -> stringPublic Shared Function GetNextTextElement (str As String, index As Integer) As StringParâ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 .
