CodePagesEncodingProvider Classe

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
Origem:
CodePagesEncodingProvider.cs
Origem:
CodePagesEncodingProvider.cs
Origem:
CodePagesEncodingProvider.cs
Origem:
CodePagesEncodingProvider.cs
Origem:
CodePagesEncodingProvider.cs
Origem:
CodePagesEncodingProvider.cs

Fornece acesso a um fornecedor de codificação para páginas de código que, de outra forma, só estariam disponíveis no desktop .NET Framework.

public ref class CodePagesEncodingProvider sealed
public ref class CodePagesEncodingProvider sealed : System::Text::EncodingProvider
[System.Security.SecurityCritical]
public sealed class CodePagesEncodingProvider
public sealed class CodePagesEncodingProvider : System.Text.EncodingProvider
[<System.Security.SecurityCritical>]
type CodePagesEncodingProvider = class
type CodePagesEncodingProvider = class
    inherit EncodingProvider
Public NotInheritable Class CodePagesEncodingProvider
Public NotInheritable Class CodePagesEncodingProvider
Inherits EncodingProvider
Herança
Object
CodePagesEncodingProvider
Herança
Object
EncodingProvider
CodePagesEncodingProvider
Atributos
SecurityCriticalAttribute

Observações

O .NET Framework para o ambiente de trabalho do Windows suporta um grande conjunto de codificações Unicode e páginas de código. .NET Core, por outro lado, suporta apenas as seguintes codificações:

  • 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.

Exceto a página de código 20127, não são suportadas codificações de páginas de código.

A classe CodePagesEncodingProvider estende-se EncodingProvider para tornar estas páginas de código disponíveis para .NET Core. Para usar estas páginas de código adicionais, faz o seguinte:

Depois de um EncodingProvider objeto ser registado, as codificações que suporta estão disponíveis chamando as sobrecargas de Encoding.GetEncoding; não deve chamar as EncodingProvider.GetEncoding sobrecargas.

Impacto no comportamento de codificação por defeito

Registar CodePagesEncodingProvider também afeta o comportamento de GetEncoding(Int32) quando chamado com um argumento codepage de 0 em .NET (Core):

  • No Windows, GetEncoding(0) devolve a codificação que corresponde à página de código ativa do sistema, que é o mesmo comportamento do .NET Framework.
  • Em plataformas não Windows, GetEncoding(0) devolve UTF-8, mantendo a consistência multiplataforma.

Quando nenhum fornecedor de codificação está registado, GetEncoding(0) devolve UTF-8 em todas as plataformas .NET Core e versões posteriores.

Propriedades

Name Description
Instance

Recebe um fornecedor de codificação para páginas de código suportadas no desktop .NET Framework, mas não na atual plataforma .NET Framework.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetEncoding(Int32, EncoderFallback, DecoderFallback)

Devolve a codificação associada ao identificador especificado da página de códigos. Os parâmetros especificam um manipulador de erros para caracteres que não podem ser codificados e sequências de bytes que não podem ser decodificadas.

(Herdado de EncodingProvider)
GetEncoding(Int32)

Devolve a codificação associada ao identificador especificado da página de códigos.
GetEncoding(String, EncoderFallback, DecoderFallback)

Devolve a codificação associada ao nome especificado. Os parâmetros especificam um manipulador de erros para caracteres que não podem ser codificados e sequências de bytes que não podem ser decodificadas.

(Herdado de EncodingProvider)
GetEncoding(String)

Devolve a codificação associada ao nome da página de código especificado.
GetEncodings()

Devolve um array que contém todas as codificações suportadas pelo CodePagesEncodingProvider.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a