System.Text Namespace
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.
Classes
Ascii |
Contém classes que representam as codificações de caracteres ASCII e Unicode, classes base abstratas para conversão de blocos de caracteres entre blocos de bytes e uma classe auxiliar que manipula e formata objetos String sem criar instâncias de String intermediárias. |
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, de outra forma, estão disponíveis apenas no .NET Framework da área de trabalho. |
CompositeFormat |
Representa uma cadeia de caracteres de formato composto analisada. |
Decoder |
Converte uma sequência de bytes codificados em um conjunto de caracteres. |
DecoderExceptionFallback |
Fornece um mecanismo de tratamento de falha chamado fallback para uma sequência de bytes codificados de entrada 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 |
Gera DecoderFallbackException quando uma sequência de bytes codificados de entrada 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 falha, chamado um fallback, para uma sequência de bytes codificados de entrada 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 para um decodificador quando ele não é capaz de decodificar uma sequência de bytes de entrada. |
DecoderFallbackException |
Exceção lançada quando uma operação de fallback do decodificador falha. Essa classe não pode ser herdada. |
DecoderReplacementFallback |
Fornece um mecanismo de tratamento de falha, chamado um fallback, para uma sequência de bytes codificados de entrada 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 falha chamado fallback para um caractere de entrada que não pode ser convertido em uma sequência de bytes de saída. O fallback gerará 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 |
Gera EncoderFallbackException quando o 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 falha chamado 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 para um codificador quando ele não é capaz de codificar um caractere de entrada. |
EncoderFallbackException |
Exceção lançada quando uma operação de fallback do codificador falha. Essa classe não pode ser herdada. |
EncoderReplacementFallback |
Fornece um mecanismo de tratamento de falha chamado 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. |
EncodingExtensions |
Fornece métodos de extensão para 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 provedor de codificação, que por sua vez fornece codificações que não estão disponíveis em uma plataforma específica. |
RedactionStringBuilderExtensions |
Métodos de utilitário de redação. |
StringBuilder |
Representa uma cadeia de caracteres mutável. Essa classe não pode ser herdada. |
UnicodeEncoding |
Representa uma codificação de caracteres Unicode UTF-16. |
UTF32Encoding |
Representa uma codificação de caracteres Unicode UTF-32. |
UTF7Encoding |
Representa uma codificação de caracteres Unicode UTF-7. |
UTF8Encoding |
Representa uma codificação de caracteres Unicode UTF-8. |
Estruturas
Rune |
Representa um valor escalar Unicode ([U+0000 a U+D7FF], incluindo esses valores; ou [U+E000 a U+10FFFF], incluindo esses valores). |
SpanLineEnumerator |
Enumera as linhas de um ReadOnlySpan<T>. |
SpanRuneEnumerator |
Fornece um enumerador para os valores de Rune representados por um intervalo contendo texto em UTF-16. |
StringBuilder.AppendInterpolatedStringHandler |
Fornece um manipulador usado pelo compilador de linguagem para acrescentar cadeias de caracteres interpoladas em StringBuilder instâncias. |
StringBuilder.ChunkEnumerator |
Dá suporte à iteração simples em partes de uma instância de StringBuilder. |
StringRuneEnumerator |
Fornece um enumerador para os valores de Rune representados por uma cadeia de caracteres. |
Enumerações
NormalizationForm |
Define o tipo de normalização a executar. |
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 A codificação (UTF-16) é usada internamente pelo .NET e Encoding.UTF8 a codificação geralmente é usada para armazenar dados de caracteres para garantir a portabilidade entre computadores e culturas.
As classes derivadas de Encoding permitem 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. Escolha uma das opções:
Fallback de exceção. Você pode optar por gerar exceções em erros de dados usando um
throwonerror
sinalizador que está disponível em alguns construtores de classe ou usando as EncoderExceptionFallback classes e DecoderExceptionFallback . Se você estiver preocupado com a integridade do fluxo de dados, é recomendável lançar em uma exceção.Fallback de substituição. Você pode usar as EncoderFallback classes e DecoderFallback 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 no .NET .