CodePagesEncodingProvider.GetEncoding Метод

Определение

Пространство имен:

System.Text

Сборка:

System.Text.Encoding.CodePages.dll

Перегрузки

Имя	Описание
GetEncoding(Int32)	Возвращает кодировку, связанную с указанным идентификатором кодовой страницы.
GetEncoding(String)	Возвращает кодировку, связанную с указанным именем кодовой страницы.

Комментарии

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

Чтобы получить кодировку, которая присутствует в .NET Framework, но не в .NET Core, сделайте следующее:

• Добавьте ссылку на сборкуSystem.Text.Encoding.CodePages.dll в проект.

• EncodingProvider Получите объект из статического CodePagesEncodingProvider.Instance свойства.

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

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

GetEncoding(Int32)

Исходный код:

CodePagesEncodingProvider.cs

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

public:
 override System::Text::Encoding ^ GetEncoding(int codepage);

public override System.Text.Encoding? GetEncoding(int codepage);

override this.GetEncoding : int -> System.Text.Encoding

Public Overrides Function GetEncoding (codepage As Integer) As Encoding

Параметры

codepage

Int32

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

Возвращаемое значение

Encoding

Кодировка, связанная с указанным идентификатором кодовой страницы или null если поставщик не поддерживает запрошенную кодировку codepage.

Комментарии

Этот метод предоставляет доступ к кодировкам кодирования кодовой страницы, которые доступны в .NET Framework, но не поддерживаются в .NET Core и более поздних версиях.

Если codepage это 0так, этот метод имеет специальное поведение, которое влияет на кодировку по умолчанию, возвращаемую GetEncoding(Int32):

• В Windows: возвращает кодировку, соответствующую активной кодовой странице системы, обеспечивая такое же поведение, как .NET Framework.
• На платформах, отличных от Windows: возвращает значение null, позволяющее GetEncoding(Int32) вернуться к по умолчанию UTF-8.

Для всех остальных поддерживаемых идентификаторов кодовой страницы этот метод возвращает соответствующую кодировку, если она доступна от поставщика кодирования кодовых страниц или null если кодовая страница не поддерживается.

GetEncoding(String)

Исходный код:

CodePagesEncodingProvider.cs

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

public:
 override System::Text::Encoding ^ GetEncoding(System::String ^ name);

public override System.Text.Encoding? GetEncoding(string name);

override this.GetEncoding : string -> System.Text.Encoding

Public Overrides Function GetEncoding (name As String) As Encoding

Параметры

name

String

Имя кодовой страницы предпочтительной кодировки, которую может поддерживать поставщик кодирования.

Возвращаемое значение

Encoding

Кодировка, связанная с указанной кодовой страницей, или null если поставщик не поддерживает запрошенную кодировку.