CodePagesEncodingProvider.GetEncoding Método

Definição

Espaço de Nomes:: System.Text

Assemblagem:: System.Text.Encoding.CodePages.dll

Pacote:: System.Text.Encoding.CodePages v11.0.0-preview.4.26230.115

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Sobrecargas

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

Observações

O .NET Framework suporta um grande número de codificações de caracteres e páginas de código. Pode obter uma lista completa de codificações chamando o método Encoding.GetEncodings, que está disponível no .NET Framework. Por outro lado, o .NET Core suporta apenas as seguintes codificações por defeito:

ASCII (página de código 20127), que é devolvida pela Encoding.ASCII propriedade.
ISO-8859-1 (página de código 28591).
UTF-7 (página de código 65000), que é devolvida pela Encoding.UTF7 propriedade.
UTF-8 (página de código 65001), que é devolvida pela Encoding.UTF8 propriedade.
UTF-16 e UTF-16LE (página de código 1200), que é devolvida pela Encoding.Unicode propriedade.
UTF-16BE (página de código 1201), que é instanciada chamando o UnicodeEncoding.UnicodeEncoding construtor or UnicodeEncoding.UnicodeEncoding com um bigEndian valor de true.
UTF-32 e UTF-32LE (página de código 12000), que é devolvida pela Encoding.UTF32 propriedade.
UTF-32BE (página de código 12001), que é instanciada ao chamar um UTF32Encoding construtor que tem um bigEndian parâmetro e fornecer um valor de true na chamada ao método.

Para recuperar uma codificação presente no .NET Framework mas não no .NET Core, faz-se o seguinte:

Adicione uma referência ao conjuntoSystem.Text.Encoding.CodePages.dll ao seu projeto.
Obtém o EncodingProvider objeto da propriedade estática CodePagesEncodingProvider.Instance .
Passar o EncodingProvider objeto ao Encoding.RegisterProvider método para tornar as codificações fornecidas pelo EncodingProvider objeto disponíveis para o runtime da common language.
Chama uma Encoding.GetEncoding sobrecarga para recuperar a codificação. O Encoding.GetEncoding método chamará o método correspondente EncodingProvider.GetEncoding para determinar se consegue fornecer a codificação solicitada.

GetEncoding(Int32)

Origem:: CodePagesEncodingProvider.cs

Origem:: CodePagesEncodingProvider.cs

Origem:: CodePagesEncodingProvider.cs

Origem:: CodePagesEncodingProvider.cs

Origem:: CodePagesEncodingProvider.cs

Origem:: CodePagesEncodingProvider.cs

Devolve a codificação associada ao identificador especificado da página de códigos.

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ódigos da codificação preferida que o fornecedor de codificação possa suportar.

Devoluções

Encoding

A codificação associada ao identificador especificado da página de códigos, ou null se o fornecedor não suportar a codificação da página de códigos solicitada.

Observações

Este método fornece acesso a codificações de páginas de código que estão disponíveis no .NET Framework, mas não são suportadas nativamente no .NET Core e versões posteriores.

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

On Windows: Devolve a codificação que corresponde à página de código ativa do sistema, fornecendo o mesmo comportamento que .NET Framework.
Em plataformas não Windows: Retorna null, permitindo que GetEncoding(Int32) volte ao seu comportamento padrão UTF-8.

Para todos os outros identificadores de página de códigos suportados, este método devolve a codificação correspondente se estiver disponível através do fornecedor de codificação das páginas de códigos, ou null se a página de código não for suportada.

Aplica-se a

GetEncoding(String)

Origem:: CodePagesEncodingProvider.cs

Origem:: CodePagesEncodingProvider.cs

Origem:: CodePagesEncodingProvider.cs

Origem:: CodePagesEncodingProvider.cs

Origem:: CodePagesEncodingProvider.cs

Origem:: CodePagesEncodingProvider.cs

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

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 preferida que o fornecedor de codificação possa suportar.

Devoluções

Encoding

A codificação associada à página de códigos especificada, ou null se o fornecedor não suportar a codificação solicitada.

Aplica-se a

Comentários

Esta página foi útil?