EncodingProvider Класс

Определение

Предоставляет базовый класс для поставщика кодировки, обеспечивающего кодировки, недоступные в определенной платформе.

public ref class EncodingProvider abstract
public abstract class EncodingProvider
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EncodingProvider
type EncodingProvider = class
[<System.Runtime.InteropServices.ComVisible(true)>]
type EncodingProvider = class
Public MustInherit Class EncodingProvider
Наследование
EncodingProvider
Производный
Атрибуты

Комментарии

Поставщик кодирования предоставляет кодировки, которые в противном случае недоступны на конкретной целевой платформе.

Платформа .NET Framework на рабочем столе Windows поддерживает большое количество кодировок символов и кодовых страниц. Полный список кодировок, доступных в платформа .NET Framework на рабочем столе Windows, можно получить, вызвав Encoding.GetEncodings метод. С другой стороны, .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), возвращаемые свойством Unicode .

  • UTF-16BE (кодовая страница 1201), которая создается путем вызова UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) или конструктора со значением bigEndian true.

  • UTF-32 и UTF-32LE (кодовая страница 12000), возвращаемые свойством Encoding.UTF32 .

  • UTF-32BE (кодовая страница 12001), которая создается путем вызова UTF32Encoding конструктора с параметром bigEndian и предоставления значения true в вызове метода.

Начиная с версии платформа .NET Framework 4.6, является базовым классом, EncodingProvider который делает недоступные кодировки недоступными для платформа .NET Framework. Для этого необходимо выполнить следующие шаги.

  1. Определите подкласс EncodingProvider , который переопределяет две абстрактные GetEncoding перегрузки и GetEncoding(Int32) GetEncoding(String). Эти перегрузки возвращают неподдерживаемую кодировку по идентификатору кодовой страницы и имени. Обратите внимание, что можно также вернуть кодировку по умолчанию, если GetEncoding(Int32) метод вызывается с аргументом 0.

  2. При необходимости можно переопределить виртуальную машину GetEncoding(Int32, EncoderFallback, DecoderFallback) и GetEncoding(String, EncoderFallback, DecoderFallback) методы. В большинстве случаев это необязательно, так как базовый класс предоставляет реализацию по умолчанию.

  3. EncodingProvider Передайте экземпляр Encoding.RegisterProvider в метод, чтобы сделать кодировки, предоставляемые EncodingProvider объектом, доступными для среды CLR.

  4. Вызовите перегрузку Encoding.GetEncoding , чтобы получить кодировку. Метод Encoding.GetEncoding вызывает соответствующий EncodingProvider.GetEncoding метод, чтобы определить, может ли он предоставить запрошенную кодировку.

Библиотека классов платформа .NET Framework предоставляет одно статическое свойство, которое возвращает EncodingProvider объект, CodePagesEncodingProvider.Instanceкоторый делает полный набор кодировок доступным на классическом платформа .NET Framework библиотеке классов, доступной для приложений .NET Core. Кроме того, можно наследовать от EncodingProvider класса, чтобы сделать свои собственные кодировки доступными.

Конструкторы

EncodingProvider()

Инициализирует новый экземпляр класса EncodingProvider.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetEncoding(Int32)

Возвращает кодировку, связанную с указанным идентификатором кодовой страницы.

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Возвращает кодировку, связанную с указанным идентификатором кодовой страницы. С помощью параметров задается обработчик ошибок для символов, которые не удается закодировать, и последовательностей байтов, которые не удается декодировать.

GetEncoding(String)

Возвращает кодировку с указанным именем.

GetEncoding(String, EncoderFallback, DecoderFallback)

Возвращает кодировку, связанную с заданным именем. С помощью параметров задается обработчик ошибок для символов, которые не удается закодировать, и последовательностей байтов, которые не удается декодировать.

GetEncodings()

Возвращает массив, содержащий все кодировки, поддерживаемые EncodingProvider.

GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к

См. также раздел