System.Text Espaço de Nomes
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.
Classes
| Name | Description |
|---|---|
| Ascii |
Fornece métodos auxiliares para trabalhar com texto codificado em ASCII sob a forma de bytes ou caracteres. |
| ASCIIEncoding |
Representa uma codificação de caracteres ASCII de caracteres Unicode. |
| CodePagesEncodingProvider |
Fornece acesso a um fornecedor de codificação para páginas de código que, de outra forma, só estariam disponíveis no desktop .NET Framework. |
| CompositeFormat |
Representa uma cadeia de formatos compostos analisados. |
| Decoder |
Converte uma sequência de bytes codificados num conjunto de caracteres. |
| DecoderExceptionFallback |
Fornece um mecanismo de gestão de falhas, chamado de recurso, para uma sequência codificada de bytes de entrada que não pode ser convertida num carácter de entrada. O fallback lança uma exceção em vez de descodificar a sequência de bytes de entrada. Esta classe não pode ser herdada. |
| DecoderExceptionFallbackBuffer |
Throws DecoderFallbackException quando uma sequência de bytes de entrada codificada não pode ser convertida num carácter de saída decodificado. Esta classe não pode ser herdada. |
| DecoderFallback |
Fornece um mecanismo de gestão de falhas, chamado de recurso, para uma sequência de bytes de entrada codificada que não pode ser convertida num carácter de saída. |
| DecoderFallbackBuffer |
Fornece um buffer que permite a um handler de reserva devolver uma string alternativa a um descodificador quando não pode decodificar uma sequência de bytes de entrada. |
| DecoderFallbackException |
A exceção que é lançada quando uma operação de retenção do descodificador falha. Esta classe não pode ser herdada. |
| DecoderReplacementFallback |
Fornece um mecanismo de gestão de falhas, chamado de recurso, para uma sequência de bytes de entrada codificada que não pode ser convertida num carácter de saída. O recurso de reserva emite uma cadeia de substituição especificada pelo utilizador em vez de uma sequência de bytes de entrada descodificada. Esta classe não pode ser herdada. |
| DecoderReplacementFallbackBuffer |
Representa uma cadeia de saída substituta que é emitida quando a sequência original de bytes de entrada não pode ser decodificada. Esta classe não pode ser herdada. |
| Encoder |
Converte um conjunto de caracteres numa sequência de bytes. |
| EncoderExceptionFallback |
Fornece um mecanismo de tratamento de falhas, chamado de reserva (fallback), para um carácter de entrada que não pode ser convertido numa sequência de bytes de saída. O fallback lança uma exceção se um carácter de entrada não puder ser convertido numa sequência de bytes de saída. Esta classe não pode ser herdada. |
| EncoderExceptionFallbackBuffer |
Lança EncoderFallbackException quando um carácter de entrada não pode ser convertido numa sequência codificada de bytes de saída. Esta classe não pode ser herdada. |
| EncoderFallback |
Fornece um mecanismo de gestão de falhas, chamado de recurso, para um carácter de entrada que não pode ser convertido numa sequência codificada de bytes de saída. |
| EncoderFallbackBuffer |
Fornece um buffer que permite a um handler de fallback devolver uma string alternativa a um codificador quando não consegue codificar um carácter de entrada. |
| EncoderFallbackException |
A exceção é lançada quando uma operação de retenção do codificador falha. Esta classe não pode ser herdada. |
| EncoderReplacementFallback |
Fornece um mecanismo de gestão de falhas, chamado de recurso, para um carácter de entrada que não pode ser convertido numa sequência de bytes de saída. O plano B utiliza uma cadeia de substituição especificada pelo utilizador em vez do carácter de entrada original. Esta classe não pode ser herdada. |
| EncoderReplacementFallbackBuffer |
Representa uma cadeia de entrada substituta que é usada quando o carácter de entrada original não pode ser codificado. Esta classe não pode ser herdada. |
| Encoding |
Representa uma codificação de caracteres. |
| EncodingExtensions |
Fornece métodos de extensão para os tipos de codificação, como Encoding, Encoder, e Decoder. |
| EncodingInfo |
Fornece informações básicas sobre uma codificação. |
| EncodingProvider |
Fornece a classe base para um fornecedor de codificação, que fornece codificações que não estão disponíveis numa determinada plataforma. |
| RedactionStringBuilderExtensions |
Métodos utilitários de redação. |
| StringBuilder |
Representa uma sequência mutável de caracteres. Esta classe não pode ser herdada. |
| UnicodeEncoding |
Representa uma codificação UTF-16 de caracteres Unicode. |
| UTF32Encoding |
Representa uma codificação UTF-32 de caracteres Unicode. |
| UTF7Encoding |
Representa uma codificação UTF-7 de caracteres Unicode. |
| UTF8Encoding |
Representa uma codificação UTF-8 de caracteres Unicode. |
Estruturas
| Name | Description |
|---|---|
| Rune |
Representa um valor escalar Unicode ([ U+0000..U+D7FF ], inclusive; ou [ U+E000.. U+10FFFF ], inclusive). |
| RunePosition |
Contém classes que representam codificações de caracteres ASCII e Unicode; classes base abstratas para converter blocos de caracteres para e a partir de blocos de bytes; e uma classe auxiliar que manipula e formata String objetos sem criar instâncias intermédias de String. |
| RunePosition.Utf16Enumerator |
Contém classes que representam codificações de caracteres ASCII e Unicode; classes base abstratas para converter blocos de caracteres para e a partir de blocos de bytes; e uma classe auxiliar que manipula e formata String objetos sem criar instâncias intermédias de String. |
| RunePosition.Utf8Enumerator |
Contém classes que representam codificações de caracteres ASCII e Unicode; classes base abstratas para converter blocos de caracteres para e a partir de blocos de bytes; e uma classe auxiliar que manipula e formata String objetos sem criar instâncias intermédias de String. |
| SpanLineEnumerator |
Enumera as retas de um ReadOnlySpan<T>. |
| SpanRuneEnumerator |
Fornece um enumerador para os Rune valores representados por um intervalo contendo texto UTF-16. |
| StringBuilder.AppendInterpolatedStringHandler |
Fornece um handler usado pelo compilador da linguagem para adicionar cadeias interpoladas às StringBuilder instâncias. |
| StringBuilder.ChunkEnumerator |
Suporta iteração simples sobre os blocos de uma StringBuilder instância. |
| StringBuilderRuneEnumerator |
Contém classes que representam codificações de caracteres ASCII e Unicode; classes base abstratas para converter blocos de caracteres para e a partir de blocos de bytes; e uma classe auxiliar que manipula e formata String objetos sem criar instâncias intermédias de String. |
| StringRuneEnumerator |
Fornece um enumerador para os Rune valores representados por uma cadeia. |
Enumerações
| Name | Description |
|---|---|
| NormalizationForm |
Define o tipo de normalização a realizar. |
Observações
As classes de codificação destinam-se principalmente a converter entre diferentes codificações ou páginas de código e uma codificação Unicode. A codificação Encoding.Unicode (UTF-16) é usada internamente pelo .NET, e a codificação Encoding.UTF8 é frequentemente usada para armazenar dados de caracteres, garantindo portabilidade entre máquinas e culturas.
As classes derivadas permitem-lhe Encoding escolher uma estratégia de recurso, que determina como são tratados caracteres que não podem ser codificados numa sequência de bytes, ou bytes que não podem ser decodificados em caracteres. Pode escolher uma das seguintes:
Exceção de recurso. Pode optar por lançar exceções em erros de dados usando uma
throwonerrorflag disponível em alguns construtores de classes ou usando as EncoderExceptionFallback classes e DecoderExceptionFallback . Se estiver preocupado com a integridade do fluxo de dados, recomenda-se adicionar uma exceção.Recuo de substituição. Pode usar as EncoderFallback classes and DecoderFallback para mudar silenciosamente um carácter para "?" ou para o carácter substituto Unicode (U+FFFD).
O plano B mais adequado. Esta opção mapeia um carácter de uma codificação para um carácter de outra codificação. O recurso de melhor encaixe muitas vezes não é recomendado porque pode causar perda de dados e confusão, e é mais lento do que simples substituições de caracteres "?" No entanto, para páginas de código ANSI, o comportamento de melhor ajuste é o padrão.
A StringBuilder classe foi concebida para operações que realizam manipulações extensas numa única cadeia. Ao contrário da String classe, a StringBuilder classe é mutável e oferece melhor desempenho ao concatenar ou eliminar strings.
Para mais informações sobre System.Text, veja Como usar classes de codificação de caracteres em .NET .