System.Text Namespace

O namespace String contém classes que representam as codificações de caracteres ASCII e Unicode; classes base abstratas para a conversão de blocos de caracteres em e de blocos de bytes; e uma classe auxiliar que manipula e formata objetos System.Text sem criar instâncias intermediárias de String. The System.Text namespace contains classes that represent ASCII and Unicode character encodings; abstract base classes for converting blocks of characters to and from blocks of bytes; and a helper class that manipulates and formats String objects without creating intermediate instances of String.

Classes

ASCIIEncoding

Representa uma codificação de caracteres ASCII de caracteres Unicode.Represents an ASCII character encoding of Unicode characters.

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.Provides access to an encoding provider for code pages that otherwise are available only in the desktop .NET Framework.

Decoder

Converte uma sequência de bytes codificados em um conjunto de caracteres.Converts a sequence of encoded bytes into a set of characters.

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.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an input character. O fallback gera uma exceção, em vez de decodificar a sequência de bytes de entrada.The fallback throws an exception instead of decoding the input byte sequence. Essa classe não pode ser herdada.This class cannot be inherited.

DecoderExceptionFallbackBuffer

Gera DecoderFallbackException quando uma sequência de bytes codificados de entrada não pode ser convertida em um caractere de saída decodificado.Throws DecoderFallbackException when an encoded input byte sequence cannot be converted to a decoded output character. Essa classe não pode ser herdada.This class cannot be inherited.

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.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an output character.

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.Provides a buffer that allows a fallback handler to return an alternate string to a decoder when it cannot decode an input byte sequence.

DecoderFallbackException

Exceção lançada quando uma operação de fallback do decodificador falha.The exception that is thrown when a decoder fallback operation fails. Essa classe não pode ser herdada.This class cannot be inherited.

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.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an output character. 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.The fallback emits a user-specified replacement string instead of a decoded input byte sequence. Essa classe não pode ser herdada.This class cannot be inherited.

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.Represents a substitute output string that is emitted when the original input byte sequence cannot be decoded. Essa classe não pode ser herdada.This class cannot be inherited.

Encoder

Converte um conjunto de caracteres em uma sequência de bytes.Converts a set of characters into a sequence of 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.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an output byte sequence. 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.The fallback throws an exception if an input character cannot be converted to an output byte sequence. Essa classe não pode ser herdada.This class cannot be inherited.

EncoderExceptionFallbackBuffer

Gera EncoderFallbackException quando o caractere de entrada não pode ser convertido em uma sequência de bytes de saída codificada.Throws EncoderFallbackException when an input character cannot be converted to an encoded output byte sequence. Essa classe não pode ser herdada.This class cannot be inherited.

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.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an encoded output byte sequence.

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.Provides a buffer that allows a fallback handler to return an alternate string to an encoder when it cannot encode an input character.

EncoderFallbackException

Exceção gerada quando uma operação de fallback do codificador falha.The exception that is thrown when an encoder fallback operation fails. Essa classe não pode ser herdada.This class cannot be inherited.

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.Provides a failure handling mechanism, called a fallback, for an input character that cannot be converted to an output byte sequence. O fallback usa uma cadeia de caracteres de substituição especificada pelo usuário, em vez do caractere de entrada original.The fallback uses a user-specified replacement string instead of the original input character. Essa classe não pode ser herdada.This class cannot be inherited.

EncoderReplacementFallbackBuffer

Representa uma cadeia de caracteres de entrada substituta que é usada quando o caractere de entrada original não pode ser codificado.Represents a substitute input string that is used when the original input character cannot be encoded. Essa classe não pode ser herdada.This class cannot be inherited.

Encoding

Representa uma codificação de caracteres.Represents a character encoding.

EncodingInfo

Fornece informações básicas sobre uma codificação.Provides basic information about an encoding.

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.Provides the base class for an encoding provider, which supplies encodings that are unavailable on a particular platform.

StringBuilder

Representa uma cadeia de caracteres mutável.Represents a mutable string of characters. Essa classe não pode ser herdada.This class cannot be inherited.

UnicodeEncoding

Representa uma codificação de caracteres Unicode UTF-16.Represents a UTF-16 encoding of Unicode characters.

UTF32Encoding

Representa uma codificação de caracteres Unicode UTF-32.Represents a UTF-32 encoding of Unicode characters.

UTF7Encoding

Representa uma codificação de caracteres Unicode UTF-7.Represents a UTF-7 encoding of Unicode characters.

UTF8Encoding

Representa uma codificação de caracteres Unicode UTF-8.Represents a UTF-8 encoding of Unicode characters.

Estruturas

Rune

Representa um valor escalar Unicode ([U+0000 a U+D7FF], incluindo esses valores; ou [U+E000 a U+10FFFF], incluindo esses valores).Represents a Unicode scalar value ([ U+0000..U+D7FF ], inclusive; or [ U+E000..U+10FFFF ], inclusive).

SpanRuneEnumerator

Fornece um enumerador para os valores de Rune representados por um intervalo contendo texto em UTF-16.Provides an enumerator for the Rune values represented by a span containing UTF-16 text.

StringBuilder.ChunkEnumerator

Dá suporte à iteração simples em partes de uma instância de StringBuilder.Supports simple iteration over the chunks of a StringBuilder instance.

StringRuneEnumerator

Fornece um enumerador para os valores de Rune representados por uma cadeia de caracteres.Provides an enumerator for the Rune values represented by a string.

Enumerações

NormalizationForm

Define o tipo de normalização a executar.Defines the type of normalization to perform.

Comentários

As classes de codificação destinam-se principalmente para converter entre codificações diferentes ou páginas de código e uma codificação Unicode.The encoding classes are primarily intended to convert between different encodings or code pages and a Unicode encoding. Encoding.Unicode A codificação (UTF-16) é usado internamente pelo .NET Framework, e Encoding.UTF8 codificação é geralmente usada para armazenar dados de caractere para garantir a portabilidade entre culturas e computadores.Encoding.Unicode (UTF-16) encoding is used internally by the .NET Framework, and Encoding.UTF8 encoding is often used for storing character data to ensure portability across machines and cultures.

As classes derivadas de Encoding permitem que você escolher 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.The classes derived from Encoding enable you to choose a fallback strategy, which determines how characters that cannot be encoded into a sequence of bytes, or bytes that cannot be decoded into characters, are handled. Você pode escolher um destes procedimentos:You can choose one of the following:

  • Fallback de exceção.Exception fallback. Você pode optar por gerar exceções em erros de dados usando um throwonerror sinalizador está disponível em alguns construtores de classe ou usando o EncoderExceptionFallback e DecoderExceptionFallback classes.You can choose to throw exceptions on data errors either by using a throwonerror flag that is available in some class constructors or by using the EncoderExceptionFallback and DecoderExceptionFallback classes. Se você estiver preocupado com a integridade do fluxo de dados, lançando uma exceção é recomendado.If you are concerned about the integrity of the data stream, throwing on an exception is recommended.

  • Fallback de substituição.Replacement fallback. Você pode usar o EncoderFallback e DecoderFallback classes alterar silenciosamente um caractere "?" ou para o caractere de substituição Unicode (U + FFFD).You can use the EncoderFallback and DecoderFallback classes to silently change a character to "?" or to the Unicode replacement character (U+FFFD).

  • Fallback de melhor ajuste.Best-fit fallback. Essa opção é mapeado para um caractere em uma codificação para um caractere em outra codificação.This option maps a character in one encoding to a character in another encoding. Fallback de ajuste recomendada geralmente não é recomendável porque pode causar perda de dados e a confusão e é mais lento do que simples "?" substituições de caracteres.Best fit fallback is often not recommended because it can cause data loss and confusion, and is slower than simple "?" character replacements. No entanto, para páginas de código ANSI, o comportamento de fallback de melhor ajuste é o padrão.However, for ANSI code pages the best-fit behavior is the default.

O StringBuilder classe foi projetada para operações que executar manipulações de extensivas em uma única cadeia de caracteres.The StringBuilder class is designed for operations that perform extensive manipulations on a single string. Ao contrário do String classe, o StringBuilder classe é mutável e fornece um melhor desempenho ao concatenar ou excluir cadeias de caracteres.Unlike the String class, the StringBuilder class is mutable and provides better performance when concatenating or deleting strings.

Para obter mais informações sobre System.Text, consulte codificação de caracteres no .NET Framework .For more information about System.Text, see Character Encoding in the .NET Framework .