EncodingProvider EncodingProvider EncodingProvider EncodingProvider Class

Определение

Предоставляет базовый класс для поставщика кодировки, обеспечивающего кодировки, недоступные в определенной платформе.Provides the base class for an encoding provider, which supplies encodings that are unavailable on a particular platform.

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

Комментарии

Поставщик кодировки предоставляет кодировки, которые иначе недоступны на определенный целевой платформы.An encoding provider supplies encodings that are not otherwise available on a particular target platform.

Платформа .NET Framework, на рабочем столе Windows поддерживает большое количество символов кодировки и кодовые страницы.The .NET Framework on the Windows desktop supports a large number of character encodings and code pages. Полный список доступных в .NET Framework кодировках можно получить на рабочем столе Windows путем вызова Encoding.GetEncodings метод.You can get a complete list of encodings available in the .NET Framework on the Windows desktop by calling the Encoding.GetEncodings method. .NET core, с другой стороны, по умолчанию поддерживает только следующие кодировки:.NET Core, on the other hand, by default supports only the following encodings:

  • ASCII (кодовая страница 20127), который возвращается методом Encoding.ASCII свойство.ASCII (code page 20127), which is returned by the Encoding.ASCII property.

  • ISO-8859-1 (кодовой страницы 28591).ISO-8859-1 (code page 28591).

  • UTF-7 (кодовая страница 65000), который возвращается методом Encoding.UTF7 свойство.UTF-7 (code page 65000), which is returned by the Encoding.UTF7 property.

  • UTF-8 (кодовая страница 65001), который возвращается методом Encoding.UTF8 свойство.UTF-8 (code page 65001), which is returned by the Encoding.UTF8 property.

  • UTF-16 и UTF-16LE (кодовая страница 1200), который возвращается методом Unicode свойство.UTF-16 and UTF-16LE (code page 1200), which is returned by the Unicode property.

  • UTF-16BE (кодовая страница 1201), который создается путем вызова UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) или UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) конструктор с bigEndian значение true.UTF-16BE (code page 1201), which is instantiated by calling the UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) or UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) constructor with a bigEndian value of true.

  • UTF-32 и UTF-32LE (кодовая страница 12000), который возвращается методом Encoding.UTF32 свойство.UTF-32 and UTF-32LE (code page 12000), which is returned by the Encoding.UTF32 property.

  • UTF-32BE (кодовая страница 12001), который создается путем вызова UTF32Encoding конструктор, который имеет bigEndian параметр и предоставляя значение true в вызове метода.UTF-32BE (code page 12001), which is instantiated by calling an UTF32Encoding constructor that has a bigEndian parameter and providing a value of true in the method call.

Начиная с .NET Framework 4.6, EncodingProvider является базовым классом, в противном случае делает недоступной кодировок, доступных в .NET Framework.Starting with the .NET Framework 4.6, EncodingProvider is the base class that makes otherwise unavailable encodings available to the .NET Framework. Это включает следующие шаги:This involves the following steps:

  1. Определяете подкласс EncodingProvider , переопределяющий два абстрактного GetEncoding перегрузки, GetEncoding(Int32) и GetEncoding(String).Define a subclass of EncodingProvider that overrides the two abstract GetEncoding overloads, GetEncoding(Int32) and GetEncoding(String). Эти перегрузки возвращают, в противном случае не поддерживается кодирование, идентификатор кодовой страницы, а также по имени.These overloads return the otherwise unsupported encoding by code page identifier and by name. Обратите внимание, что вы также можете возвращают значение по умолчанию, кодирования, если GetEncoding(Int32) метод вызывается с аргументом 0.Note that you can also choose to return a default encoding if the GetEncoding(Int32) method is called with an argument of 0.

  2. При необходимости можно переопределить виртуальный GetEncoding(Int32, EncoderFallback, DecoderFallback) и GetEncoding(String, EncoderFallback, DecoderFallback) методы.Optionally, you can override the virtual GetEncoding(Int32, EncoderFallback, DecoderFallback) and GetEncoding(String, EncoderFallback, DecoderFallback) methods. В большинстве случаев это необязательно, так как базовый класс предоставляет реализацию по умолчанию.In most cases, this is not necessary, since the base class provides a default implementation.

  3. Передайте EncodingProvider экземпляр Encoding.RegisterProvider метод кодировки, предоставляемые EncodingProvider объект, доступный в среде CLR.Pass the EncodingProvider instance to the Encoding.RegisterProvider method to make the encodings supplied by the EncodingProvider object available to the common language runtime.

  4. Вызовите Encoding.GetEncoding перегрузку для получения кодировку.Call an Encoding.GetEncoding overload to retrieve the encoding. Encoding.GetEncoding Метод произойдет вызов соответствующего EncodingProvider.GetEncoding для определения ли может быть предоставлен запрошенной кодировки.The Encoding.GetEncoding method will call the corresponding EncodingProvider.GetEncoding to determine whether it can supply the requested encoding.

Библиотеки классов .NET Framework предоставляет один статическое свойство CodePagesEncodingProvider.Instance, который возвращает EncodingProvider объекта, предоставляющая полный набор кодировок на классических библиотеки классов .NET Framework для .NET Core.NET Core приложений.The .NET Framework Class Library provides one static property, CodePagesEncodingProvider.Instance, that returns an EncodingProvider object that makes the full set of encodings available on the desktop .NET Framework Class Library available to .NET Core.NET Core applications. Кроме того, можно унаследовать EncodingProvider класс для предоставления собственных кодировки.In addition, you can derive from the EncodingProvider class to make your own encodings available.

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

EncodingProvider() EncodingProvider() EncodingProvider() EncodingProvider()

Инициализирует новый экземпляр класса EncodingProvider.Initializes a new instance of the EncodingProvider class.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32)

Возвращает кодировку, связанную с указанным идентификатором кодовой страницы.Returns the encoding associated with the specified code page identifier.

GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback)

Возвращает кодировку, связанную с указанным идентификатором кодовой страницы.Returns the encoding associated with the specified code page identifier. С помощью параметров задается обработчик ошибок для символов, которые не удается закодировать, и последовательностей байтов, которые не удается декодировать.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncoding(String) GetEncoding(String) GetEncoding(String) GetEncoding(String)

Возвращает кодировку с указанным именем.Returns the encoding with the specified name.

GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback)

Возвращает кодировку, связанную с заданным именем.Returns the encoding associated with the specified name. С помощью параметров задается обработчик ошибок для символов, которые не удается закодировать, и последовательностей байтов, которые не удается декодировать.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

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

Дополнительно