Поделиться через


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
Наследование
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.UnicodeEncoding

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

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

Кроме кодовой страницы 20127, кодирование кодовой страницы не поддерживается.

Класс CodePagesEncodingProvider расширяется EncodingProvider , чтобы сделать эти кодовые страницы доступными для .NET Core. Чтобы использовать эти дополнительные кодовые страницы, выполните следующие действия.

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)

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