System.Text Espaço de Nomes

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.

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 throwonerror flag 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 .