CodePagesEncodingProvider.GetEncoding Método

Definição

Namespace:

System.Text

Assembly:

System.Text.Encoding.CodePages.dll

Sobrecargas

Nome	Description
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 especificado.

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 só dá suporte à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 UnicodeEncoding.UnicodeEncoding construtor ou UnicodeEncoding.UnicodeEncoding com um bigEndian valor de true.

• 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 que está 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)

Origem:

CodePagesEncodingProvider.cs

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);

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

Public Overrides Function GetEncoding (codepage As Integer) As Encoding

Parâmetros

codepage

Int32

O identificador de página de código da codificação preferencial 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.

Comentários

Esse método fornece acesso a codificações de página de código que estão disponíveis no .NET Framework, mas sem suporte nativo no .NET Core e versões posteriores.

Quando codepage é 0, esse método tem um comportamento especial que afeta a codificação padrão retornada por GetEncoding(Int32):

• No Windows: retorna a codificação que corresponde à página de código ativo do sistema, fornecendo o mesmo comportamento que o .NET Framework.
• Em plataformas que não são do Windows: retorna null, permitindo GetEncoding(Int32) fazer fallback para seu comportamento padrão UTF-8.

Para todos os outros identificadores de página de código com suporte, esse método retornará a codificação correspondente se estiver disponível no provedor de codificação de páginas de código ou null se não houver suporte para a página de código.

GetEncoding(String)

Origem:

CodePagesEncodingProvider.cs

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

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

Parâmetros

name

String

O nome da página de código da codificação preferencial 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.