CodePagesEncodingProvider Class
Provides access to an encoding provider for code pages supported in the desktop .NET Framework but not in .NET Core.
Namespace: System.Text
Assembly: System.Text.Encoding.CodePages (in System.Text.Encoding.CodePages.dll)
The CodePagesEncodingProvider type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | Equals(Object) | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
![]() | GetEncoding(Int32) | Returns the encoding associated with the specified code page identifier. (Overrides EncodingProvider::GetEncoding(Int32).) |
![]() | GetEncoding(String) | Returns the encoding with the specified name. (Overrides EncodingProvider::GetEncoding(String).) |
![]() | 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. (Inherited from EncodingProvider.) |
![]() | 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. (Inherited from EncodingProvider.) |
![]() | GetHashCode | Serves as the default hash function. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
Note |
|---|
CodePagesEncodingProvider class is supported in .NET Core only. |
The .NET Framework for the Windows desktop supports a large set of Unicode and code page encodings. .NET Core, on the other hand, supports only the following encodings:
ASCII (code page 20127), which is returned by the Encoding::ASCII property.
ISO-8859-1 (code page 28591).
UTF-7 (code page 65000), which is returned by the Encoding::UTF7 property.
UTF-8 (code page 65001), which is returned by the Encoding::UTF8 property.
UTF-16 and UTF-16LE (code page 1200), which is returned by the Unicode property.
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 and UTF-32LE (code page 12000), which is returned by the Encoding::UTF32 property.
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.
Other than code page 20127, code page encodings are not supported.
The CodePagesEncodingProvider class extends EncodingProvider to make these code pages available to .NET Framework 4.6. To use these additional code pages, you do the following:
Add a reference to the System.Text.Encoding.CodePages.dll assembly to your project.
Retrieve a CodePagesEncodingProvider object from the static Instance property.
Pass the CodePagesEncodingProvider object to the Encoding::RegisterProvider method.
After an EncodingProvider object is registered, the encodings that it makes supports are available by calling the overloads of Encoding::GetEncoding; you should not call the CodePagesEncodingProvider::GetEncoding overloads.
