System.Text Namespace

Contém classes que representam codificações de caracteres ASCII e Unicode; classes base abstratas para converter blocos de caracteres de e para blocos de bytes; e uma classe auxiliar que manipula e formata String objetos sem criar instâncias intermediárias de String.

Classes

Nome Description
ASCIIEncoding

Representa uma codificação de caracteres ASCII de caracteres Unicode.

CodePagesEncodingProvider

Fornece acesso a um provedor de codificação para páginas de código que, caso contrário, estão disponíveis apenas no .NET Framework da área de trabalho.

Decoder

Converte uma sequência de bytes codificados em um conjunto de caracteres.

DecoderExceptionFallback

Fornece um mecanismo de tratamento de falhas, chamado de fallback, para uma sequência de bytes de entrada codificada que não pode ser convertida em um caractere de entrada. O fallback gera uma exceção em vez de decodificar a sequência de bytes de entrada. Essa classe não pode ser herdada.

DecoderExceptionFallbackBuffer

DecoderFallbackException Gera quando uma sequência de bytes de entrada codificada não pode ser convertida em um caractere de saída decodificado. Essa classe não pode ser herdada.

DecoderFallback

Fornece um mecanismo de tratamento de falhas, chamado de fallback, para uma sequência de bytes de entrada codificada que não pode ser convertida em um caractere de saída.

DecoderFallbackBuffer

Fornece um buffer que permite que um manipulador de fallback retorne uma cadeia de caracteres alternativa a um decodificador quando ele não puder decodificar uma sequência de bytes de entrada.

DecoderFallbackException

A exceção gerada quando uma operação de fallback do decodificador falha. Essa classe não pode ser herdada.

DecoderReplacementFallback

Fornece um mecanismo de tratamento de falhas, chamado de fallback, para uma sequência de bytes de entrada codificada que não pode ser convertida em um caractere de saída. O fallback emite uma cadeia de caracteres de substituição especificada pelo usuário em vez de uma sequência de bytes de entrada decodificada. Essa classe não pode ser herdada.

DecoderReplacementFallbackBuffer

Representa uma cadeia de caracteres de saída substituta que é emitida quando a sequência de bytes de entrada original não pode ser decodificada. Essa classe não pode ser herdada.

Encoder

Converte um conjunto de caracteres em uma sequência de bytes.

EncoderExceptionFallback

Fornece um mecanismo de tratamento de falhas, chamado de fallback, para um caractere de entrada que não pode ser convertido em uma sequência de bytes de saída. O fallback gera uma exceção se um caractere de entrada não puder ser convertido em uma sequência de bytes de saída. Essa classe não pode ser herdada.

EncoderExceptionFallbackBuffer

EncoderFallbackException Gera quando um caractere de entrada não pode ser convertido em uma sequência de bytes de saída codificada. Essa classe não pode ser herdada.

EncoderFallback

Fornece um mecanismo de tratamento de falhas, chamado de fallback, para um caractere de entrada que não pode ser convertido em uma sequência de bytes de saída codificada.

EncoderFallbackBuffer

Fornece um buffer que permite que um manipulador de fallback retorne uma cadeia de caracteres alternativa a um codificador quando ele não puder codificar um caractere de entrada.

EncoderFallbackException

A exceção gerada quando uma operação de fallback do codificador falha. Essa classe não pode ser herdada.

EncoderReplacementFallback

Fornece um mecanismo de tratamento de falhas, chamado de fallback, para um caractere de entrada que não pode ser convertido em uma sequência de bytes de saída. O fallback usa uma cadeia de caracteres de substituição especificada pelo usuário em vez do caractere de entrada original. Essa classe não pode ser herdada.

EncoderReplacementFallbackBuffer

Representa uma cadeia de caracteres de entrada substituta que é usada quando o caractere de entrada original não pode ser codificado. Essa classe não pode ser herdada.

Encoding

Representa uma codificação de caracteres.

EncodingInfo

Fornece informações básicas sobre uma codificação.

EncodingProvider

Fornece a classe base para um provedor de codificação, que fornece codificações que não estão disponíveis em uma plataforma específica.

StringBuilder

Representa uma cadeia de caracteres mutável. Essa 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.

Enumerações

Nome Description
NormalizationForm

Define o tipo de normalização a ser executada.

Comentários

As classes de codificação destinam-se principalmente à conversão entre diferentes codificações ou páginas de código e uma codificação Unicode. Encoding.Unicode (UTF-16) codificação é usada internamente por .NET e a codificação Encoding.UTF8 geralmente é usada para armazenar dados de caractere para garantir a portabilidade entre máquinas e culturas.

As classes derivadas permitem Encoding que você escolha uma estratégia de fallback, que determina como os caracteres que não podem ser codificados em uma sequência de bytes ou bytes que não podem ser decodificados em caracteres são tratados. Você pode escolher um dos seguintes:

  • Fallback de exceção. Você pode optar por lançar exceções em erros de dados usando um throwonerror sinalizador disponível em alguns construtores de classe ou usando as classes eDecoderExceptionFallback.EncoderExceptionFallback Se você estiver preocupado com a integridade do fluxo de dados, é recomendável gerar uma exceção.

  • Fallback de substituição. Você pode usar e EncoderFallbackDecoderFallback classes para alterar silenciosamente um caractere para "?" ou para o caractere de substituição Unicode (U+FFFD).

  • Fallback de melhor ajuste. Essa opção mapeia um caractere em uma codificação para um caractere em outra codificação. O fallback de melhor ajuste geralmente não é recomendado porque pode causar perda e confusão de dados e é mais lento do que as substituições de caracteres simples "?". No entanto, para páginas de código ANSI, o comportamento de melhor ajuste é o padrão.

A StringBuilder classe foi projetada para operações que executam manipulações extensas em uma única cadeia de caracteres. Ao contrário da String classe, a StringBuilder classe é mutável e fornece melhor desempenho ao concatenar ou excluir cadeias de caracteres.

Para obter mais informações sobre System.Text, consulte Como usar classes de codificação de caracteres em .NET .