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.

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. Наиболее подходящая fallback часто не рекомендуется, поскольку это может вызвать потерю данных и путаницы и выполняется медленнее, чем простой «?» символ замены.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 .