CodePagesEncodingProvider.GetEncoding Method

Definition

Namespace:

System.Text

Assembly:

System.Text.Encoding.CodePages.dll

Overloads

GetEncoding(Int32)	Returns the encoding associated with the specified code page identifier.
GetEncoding(String)	Returns the encoding associated with the specified code page name.

Remarks

The .NET Framework supports a large number of character encodings and code pages. You can get a complete list of encodings by calling the Encoding.GetEncodings method, which is available in the .NET Framework. On the other hand, .NET Core only supports the following encodings by default:

• 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 Encoding.Unicode property.

• UTF-16BE (code page 1201), which is instantiated by calling the UnicodeEncoding.UnicodeEncoding or UnicodeEncoding.UnicodeEncoding 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.

To retrieve an encoding that is present in .NET Framework but not in .NET Core, you do the following:

• Add a reference to the System.Text.Encoding.CodePages.dll assembly to your project.

• Get the EncodingProvider object from the static CodePagesEncodingProvider.Instance property.

• Pass the EncodingProvider object to the Encoding.RegisterProvider method to make the encodings supplied by the EncodingProvider object available to the common language runtime.

• Call an Encoding.GetEncoding overload to retrieve the encoding. The Encoding.GetEncoding method will call the corresponding EncodingProvider.GetEncoding method to determine whether it can supply the requested encoding.

GetEncoding(Int32)

Source:

CodePagesEncodingProvider.cs

Returns the encoding associated with the specified code page identifier.

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

Parameters

codepage

Int32

The code page identifier of the preferred encoding which the encoding provider may support.

Returns

Encoding

The encoding associated with the specified code page identifier, or null if the provider does not support the requested codepage encoding.

GetEncoding(String)

Source:

CodePagesEncodingProvider.cs

Returns the encoding associated with the specified code page name.

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

Parameters

name

String

The code page name of the preferred encoding which the encoding provider may support.

Returns

Encoding

The encoding associated with the specified code page, or null if the provider does not support the requested encoding.