CodePagesEncodingProvider.GetEncoding Método

Definição

Namespace:

System.Text

Assembly:

System.Text.Encoding.CodePages.dll

Sobrecargas

GetEncoding(Int32)	Retorna a codificação associada ao identificador de página de código especificado.
GetEncoding(String)	Retorna a codificação associada ao nome da página de código especificada.

Comentários

O .NET Framework dá suporte a um grande número de codificações de caracteres e páginas de código. Você pode obter uma lista completa de codificações chamando o Encoding.GetEncodings método, que está disponível no .NET Framework. Por outro lado, o .NET Core dá suporte apenas às seguintes codificações por padrão:

• ASCII (página de código 20127), que é retornada pela Encoding.ASCII propriedade.

• ISO-8859-1 (página de código 28591).

• UTF-7 (página de código 65000), que é retornada pela Encoding.UTF7 propriedade.

• UTF-8 (página de código 65001), que é retornada pela Encoding.UTF8 propriedade.

• UTF-16 e UTF-16LE (página de código 1200), que é retornada pela Encoding.Unicode propriedade.

• UTF-16BE (página de código 1201), que é instanciada chamando o construtor ou o UnicodeEncoding.UnicodeEncoding construtor com um bigEndian valor de true.UnicodeEncoding.UnicodeEncoding

• UTF-32 e UTF-32LE (página de código 12000), que é retornada pela Encoding.UTF32 propriedade.

• UTF-32BE (página de código 12001), que é instanciada chamando um UTF32Encoding construtor que tem um bigEndian parâmetro e fornecendo um valor na chamada de true método.

Para recuperar uma codificação presente no .NET Framework, mas não no .NET Core, faça o seguinte:

• Adicione uma referência ao assemblySystem.Text.Encoding.CodePages.dll ao seu projeto.

• Obtenha o EncodingProvider objeto da propriedade estática CodePagesEncodingProvider.Instance .

• Passe o EncodingProvider objeto para o Encoding.RegisterProvider método para disponibilizar as codificações fornecidas pelo EncodingProvider objeto para o common language runtime.

• Chame uma Encoding.GetEncoding sobrecarga para recuperar a codificação. O Encoding.GetEncoding método chamará o método correspondente EncodingProvider.GetEncoding para determinar se ele pode fornecer a codificação solicitada.

GetEncoding(Int32)

Retorna a codificação associada ao identificador de página de código especificado.

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

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

Parâmetros

codepage

Int32

O identificador da página de código da codificação preferencial a que o provedor de codificação pode dar suporte.

Retornos

Encoding

A codificação associada ao identificador de página de código especificado ou null se o provedor não dá suporte à codificação de página de código solicitada.

GetEncoding(String)

Retorna a codificação associada ao nome da página de código especificada.

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

public override System.Text.Encoding GetEncoding (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

Parâmetros

name

String

O nome da página de código da codificação preferencial a que o provedor de codificação pode dar suporte.

Retornos

Encoding

A codificação associada à página de código especificada ou null se o provedor não dá suporte à codificação solicitada.