Partilhar via


System.Text Namespace

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.

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 .