System.Text Пространство имен

Пространство именSystem.Text содержит классы, которые представляют кодировки ASCII и Юникода; абстрактные базовые классы для преобразования блоков знаков в блоки байтов и обратно; вспомогательный класс, который обрабатывает и форматирует объекты String, не создавая промежуточные экземпляры 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.

Классы

ASCIIEncoding

Представляет кодировку ASCII символов Юникода.Represents an ASCII character encoding of Unicode characters.

CodePagesEncodingProvider

Предоставляет доступ к поставщику кодировки для кодовых страниц, которые в противном случае доступны только в .NET Framework для настольных систем.Provides access to an encoding provider for code pages that otherwise are available only in the desktop .NET Framework.

Decoder

Конвертирует последовательность закодированных байтов в набор символов.Converts a sequence of encoded bytes into a set of characters.

DecoderExceptionFallback

Предоставляет механизм обработки ошибок, называемый резервным вариантом, для закодированной входной последовательности байтов, которая не может быть преобразована во входной символ.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an input character. Этот резервный механизм выдает исключение вместо декодирования входной последовательности байтов.The fallback throws an exception instead of decoding the input byte sequence. Этот класс не наследуется.This class cannot be inherited.

DecoderExceptionFallbackBuffer

Создает исключение DecoderFallbackException, если закодированная входная последовательность байтов не может быть преобразована в декодированный выходной символ.Throws DecoderFallbackException when an encoded input byte sequence cannot be converted to a decoded output character. Этот класс не наследуется.This class cannot be inherited.

DecoderFallback

Предоставляет механизм обработки ошибок, называемый резервным вариантом, закодированной входной последовательности байтов, которая не может быть преобразована в выходной символ.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an output character.

DecoderFallbackBuffer

Предоставляет буфер, позволяющий резервному обработчику возвращать в декодер альтернативную строку, если он не может декодировать входную последовательность байтов.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

Исключение создается при сбое операции резервирования декодера.The exception that is thrown when a decoder fallback operation fails. Этот класс не наследуется.This class cannot be inherited.

DecoderReplacementFallback

Предоставляет механизм обработки ошибок, называемый резервным вариантом, закодированной входной последовательности байтов, которая не может быть преобразована в выходной символ.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an output character. В резервном варианте вместо декодированной последовательности байтов выпускается заданная пользователем замещающая строка.The fallback emits a user-specified replacement string instead of a decoded input byte sequence. Этот класс не наследуется.This class cannot be inherited.

DecoderReplacementFallbackBuffer

Представляет заменяющую выходную строку, которая подставляется в случаях, когда не может быть декодирована первоначальная входная последовательность байтов.Represents a substitute output string that is emitted when the original input byte sequence cannot be decoded. Этот класс не наследуется.This class cannot be inherited.

Encoder

Конвертирует набор символов в последовательность байтов.Converts a set of characters into a sequence of bytes.

EncoderExceptionFallback

Предоставляет механизм обработки ошибок, называемый резервным вариантом, для входного символа, который не может быть преобразован в выходную последовательность байтов.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an output byte sequence. Резервный механизм создает исключение, если входной символ не может быть преобразован в закодированную выходную последовательность байтов.The fallback throws an exception if an input character cannot be converted to an output byte sequence. Этот класс не наследуется.This class cannot be inherited.

EncoderExceptionFallbackBuffer

Создает исключение EncoderFallbackException, когда входной символ не может быть преобразован в закодированную выходную последовательность байтов.Throws EncoderFallbackException when an input character cannot be converted to an encoded output byte sequence. Этот класс не наследуется.This class cannot be inherited.

EncoderFallback

Предоставляет механизм обработки ошибок, называемый резервным вариантом, для входного символа, который не может быть преобразован в выходную последовательность закодированных байтов.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an encoded output byte sequence.

EncoderFallbackBuffer

Предоставляет буфер, позволяющий резервному обработчику возвращать в кодировщик альтернативную строку, если он не может закодировать входной символ.Provides a buffer that allows a fallback handler to return an alternate string to an encoder when it cannot encode an input character.

EncoderFallbackException

Исключение, которое вызывается при сбое во время операции резервирования кодировщика.The exception that is thrown when an encoder fallback operation fails. Этот класс не наследуется.This class cannot be inherited.

EncoderReplacementFallback

Предоставляет механизм обработки ошибок, называемый резервным вариантом, для входного символа, который не может быть преобразован в выходную последовательность байтов.Provides a failure handling mechanism, called a fallback, for an input character that cannot be converted to an output byte sequence. В резервном варианте вместо первоначального входного символа используется заданная пользователем замещающая строка.The fallback uses a user-specified replacement string instead of the original input character. Этот класс не наследуется.This class cannot be inherited.

EncoderReplacementFallbackBuffer

Представляет заменяющую входную строку, которая используется в случаях, когда входной символ не может быть декодирован.Represents a substitute input string that is used when the original input character cannot be encoded. Этот класс не наследуется.This class cannot be inherited.

Encoding

Представляет кодировку символов.Represents a character encoding.

EncodingExtensions

Предоставляет методы расширения для типов кодирования, такие как Encoding, Encoder и Decoder.Provides extension methods for the encoding types, such as Encoding, Encoder, and Decoder.

EncodingInfo

Предоставляет базовые сведения о кодировке.Provides basic information about an encoding.

EncodingProvider

Предоставляет базовый класс для поставщика кодировки, обеспечивающего кодировки, недоступные в определенной платформе.Provides the base class for an encoding provider, which supplies encodings that are unavailable on a particular platform.

StringBuilder

Предоставляет изменяемую строку символов.Represents a mutable string of characters. Этот класс не наследуется.This class cannot be inherited.

UnicodeEncoding

Представляет кодировку символов Юникода в формате UTF-16.Represents a UTF-16 encoding of Unicode characters.

UTF32Encoding

Представляет кодировку символов Юникода в формате UTF-32.Represents a UTF-32 encoding of Unicode characters.

UTF7Encoding

Представляет кодировку UTF-7 символов Юникода.Represents a UTF-7 encoding of Unicode characters.

UTF8Encoding

Представляет кодировку символов Юникода в формате UTF-8.Represents a UTF-8 encoding of Unicode characters.

Структуры

Rune

Представляет скалярное значение Юникода ([U+0000.. U+D7FF] включительно или [U+E000..U+10FFFF] включительно).Represents a Unicode scalar value ([ U+0000..U+D7FF ], inclusive; or [ U+E000..U+10FFFF ], inclusive).

SpanRuneEnumerator

Предоставляет перечислитель для значений Rune, представленных диапазоном текста в кодировке UTF-16.Provides an enumerator for the Rune values represented by a span containing UTF-16 text.

StringBuilder.ChunkEnumerator

Поддерживает простую итерацию блоков экземпляра StringBuilder.Supports simple iteration over the chunks of a StringBuilder instance.

StringRuneEnumerator

Предоставляет перечислитель для значений Rune, представленных строкой.Provides an enumerator for the Rune values represented by a string.

Перечисления

NormalizationForm

Определяет тип выполняемой нормализации.Defines the type of normalization to perform.

Комментарии

Классы кодирования в основном предназначены для преобразования между различными кодировками или кодовыми страницами и кодировкой Юникода.The encoding classes are primarily intended to convert between different encodings or code pages and a Unicode encoding. Encoding.Unicode(UTF-16) используется для внутренних целей .NET Framework, а Encoding.UTF8 кодирование часто используется для хранения символьных данных, чтобы обеспечить переносимость между компьютерами и культурами.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.

Классы, производные от, Encoding позволяют выбрать резервную стратегию, которая определяет, как обрабатываются символы, которые не могут быть закодированы в последовательность байтов, или байты, которые не могут быть декодированы в символы.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. Можно выбрать один из следующих элементов:You can choose one of the following:

  • Откат исключения.Exception fallback. Вы можете создавать исключения для ошибок данных с помощью throwonerror флага, доступного в некоторых конструкторах классов или с помощью EncoderExceptionFallback DecoderExceptionFallback классов и.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. Если вы беспокоитесь о целостности потока данных, рекомендуется создавать исключение.If you are concerned about the integrity of the data stream, throwing on an exception is recommended.

  • Замена резервной.Replacement fallback. Можно использовать EncoderFallback DecoderFallback классы и для автоматического изменения символа на "?" или в символ замены Юникода (U + FFFD).You can use the EncoderFallback and DecoderFallback classes to silently change a character to "?" or to the Unicode replacement character (U+FFFD).

  • Стратегия наилучшего соответствия.Best-fit fallback. Этот параметр сопоставляет символ в одной кодировке с символом в другой кодировке.This option maps a character in one encoding to a character in another encoding. Резервные стратегии наилучшего соответствия часто не рекомендуются, так как это может привести к потере и путанице данных и медленнее, чем простые замены символов "?".Best fit fallback is often not recommended because it can cause data loss and confusion, and is slower than simple "?" character replacements. Однако для кодовых страниц ANSI оптимальным поведением является значение по умолчанию.However, for ANSI code pages the best-fit behavior is the default.

StringBuilderКласс предназначен для операций, выполняющих обширные манипуляции с одной строкой.The StringBuilder class is designed for operations that perform extensive manipulations on a single string. В отличие от String класса, StringBuilder класс является изменяемым и обеспечивает лучшую производительность при объединении или удалении строк.Unlike the String class, the StringBuilder class is mutable and provides better performance when concatenating or deleting strings.

Дополнительные сведения о см System.Text . в разделе кодировка символов в .NET Framework .For more information about System.Text, see Character Encoding in the .NET Framework .