StringInfo.GetNextTextElement Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe o primeiro elemento de texto numa cadeia especificada.
Sobrecargas
| Name | Description |
|---|---|
| GetNextTextElement(String) |
Recebe o primeiro elemento de texto numa cadeia especificada. |
| GetNextTextElement(String, Int32) |
Obtém o elemento de texto no índice especificado da cadeia especificada. |
GetNextTextElement(String)
Recebe o primeiro elemento de texto numa cadeia 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 onde se deve obter o elemento de texto.
Devoluções
Uma cadeia contendo o primeiro elemento de texto na cadeia especificada.
Exceções
str é null.
Observações
.NET define um elemento de texto como uma unidade de texto que é apresentada como um único carácter, ou seja, um grafema. Um elemento de texto pode ser um carácter base, um par substituto ou uma sequência combinativa de caracteres. A Norma Unicode define um par substituto como uma representação codificada de caracteres para um único carácter abstrato que consiste numa sequência de duas unidades de código, onde a primeira unidade do par é um substituto alto e a segunda é um substituto baixo. O Padrão Unicode define uma sequência de caracteres combinados como uma combinação de um carácter base e um ou mais caracteres combinados. Um par substituto pode representar um carácter base ou um carácter combinado.
Este método só devolve o primeiro elemento de texto. Para iterar pelos elementos de texto da cadeia, a aplicação deve usar o TextElementEnumerator objeto gerado pelo GetTextElementEnumerator método.
Ver também
Aplica-se a
GetNextTextElement(String, Int32)
Obtém o elemento de texto no índice especificado da cadeia 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 onde se deve obter o elemento de texto.
- index
- Int32
O índice baseado em zero onde o elemento de texto começa.
Devoluções
Uma cadeia contendo o elemento de texto no índice especificado da cadeia especificada.
Exceções
str é null.
index está fora do intervalo de índices válidos para str.
Observações
.NET define um elemento de texto como uma unidade de texto que é apresentada como um único carácter, ou seja, um grafema. Um elemento de texto pode ser um carácter base, um par substituto ou uma sequência combinativa de caracteres. A Norma Unicode define um par substituto como uma representação codificada de caracteres para um único carácter abstrato que consiste numa sequência de duas unidades de código, onde a primeira unidade do par é um substituto alto e a segunda é um substituto baixo. O Padrão Unicode define uma sequência de caracteres combinados como uma combinação de um carácter base e um ou mais caracteres combinados. Um par substituto pode representar um carácter base ou um carácter combinado.
Este método apenas devolve o primeiro elemento de texto da subcadeia que começa no índice especificado. Para iterar pelos elementos de texto da cadeia, a aplicação deve usar o TextElementEnumerator gerado pelo GetTextElementEnumerator método.