CodePagesEncodingProvider Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет доступ к поставщику кодирования для кодов, которые в противном случае доступны только в классической платформе .NET Framework.
public ref class CodePagesEncodingProvider sealed
public ref class CodePagesEncodingProvider sealed : System::Text::EncodingProvider
[System.Security.SecurityCritical]
public sealed class CodePagesEncodingProvider
public sealed class CodePagesEncodingProvider : System.Text.EncodingProvider
[<System.Security.SecurityCritical>]
type CodePagesEncodingProvider = class
type CodePagesEncodingProvider = class
inherit EncodingProvider
Public NotInheritable Class CodePagesEncodingProvider
Public NotInheritable Class CodePagesEncodingProvider
Inherits EncodingProvider
- Наследование
-
CodePagesEncodingProvider
- Наследование
- Атрибуты
Комментарии
Платформа .NET Framework для рабочего стола Windows поддерживает большой набор кодировк Юникода и кодовой страницы. С другой стороны, .NET Core поддерживает только следующие кодировки:
ASCII (кодовая страница 20127), возвращаемая свойством Encoding.ASCII .
ISO-8859-1 (кодовая страница 28591).
UTF-7 (кодовая страница 65000), возвращаемая свойством Encoding.UTF7 .
UTF-8 (кодовая страница 65001), возвращаемая свойством Encoding.UTF8 .
UTF-16 и UTF-16LE (кодовая страница 1200), возвращаемая свойством Encoding.Unicode .
UTF-16BE (кодовая страница 1201), которая создается путем вызова UnicodeEncoding.UnicodeEncoding или конструктора со значением
bigEndiantrue.UnicodeEncoding.UnicodeEncodingUTF-32 и UTF-32LE (кодовая страница 12000), возвращаемая свойством Encoding.UTF32 .
UTF-32BE (кодовая страница 12001), которая создается путем вызова UTF32Encoding конструктора с параметром
bigEndianи предоставления значенияtrueв вызове метода.
Кроме кодовой страницы 20127, кодирование кодовой страницы не поддерживается.
Класс CodePagesEncodingProvider расширяется EncodingProvider , чтобы сделать эти кодовые страницы доступными для .NET Core. Чтобы использовать эти дополнительные кодовые страницы, выполните следующие действия.
CodePagesEncodingProvider Извлеките объект из статического CodePagesEncodingProvider.Instance свойства.
CodePagesEncodingProvider Передайте объект методуEncoding.RegisterProvider.
EncodingProvider После регистрации объекта кодировки, поддерживаемые ею, вызывают перегрузкиEncoding.GetEncoding; не следует вызывать EncodingProvider.GetEncoding перегрузки.
Влияние на поведение кодировки по умолчанию
Регистрация CodePagesEncodingProvider также влияет на поведение GetEncoding(Int32) при вызове с аргументом codepage0 в .NET (Core):
- В Windows
GetEncoding(0)возвращает кодировку, соответствующую активной кодовой странице системы, которая аналогична поведению в .NET Framework. - На платформах, отличных от Windows,
GetEncoding(0)возвращает UTF-8, поддерживая кроссплатформенную согласованность.
Если поставщик кодирования не зарегистрирован, GetEncoding(0) возвращает UTF-8 на всех платформах в .NET Core и более поздних версиях.
Свойства
| Имя | Описание |
|---|---|
| Instance |
Возвращает поставщик кодирования для кодов, поддерживаемых в классической платформе .NET Framework, но не на текущей платформе .NET Framework. |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetEncoding(Int32, EncoderFallback, DecoderFallback) |
Возвращает кодировку, связанную с указанным идентификатором кодовой страницы. Параметры указывают обработчик ошибок для символов, которые не могут быть закодированы и байтовые последовательности, которые не могут быть декодированы. (Унаследовано от EncodingProvider) |
| GetEncoding(Int32) |
Возвращает кодировку, связанную с указанным идентификатором кодовой страницы. |
| GetEncoding(String, EncoderFallback, DecoderFallback) |
Возвращает кодировку, связанную с указанным именем. Параметры указывают обработчик ошибок для символов, которые не могут быть закодированы и байтовые последовательности, которые не могут быть декодированы. (Унаследовано от EncodingProvider) |
| GetEncoding(String) |
Возвращает кодировку, связанную с указанным именем кодовой страницы. |
| GetEncodings() |
Возвращает массив, содержащий все кодировки, поддерживаемые этим элементом CodePagesEncodingProvider. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |