CodePagesEncodingProvider Classe

Definição

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

Comentários

O .NET Framework para a área de trabalho do Windows dá suporte a um grande conjunto de codificações unicode e de página de código. O .NET Core, por outro lado, dá suporte apenas às seguintes codificações:

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

Além da página de código 20127, não há suporte para codificações de página de código.

A CodePagesEncodingProvider classe se estende para disponibilizar essas páginas EncodingProvider de código para o .NET Core. Para usar essas páginas de código adicionais, faça o seguinte:

• Recupere um CodePagesEncodingProvider objeto da propriedade estática CodePagesEncodingProvider.Instance .

• Passe o CodePagesEncodingProvider objeto para o Encoding.RegisterProvider método.

Depois que um EncodingProvider objeto é registrado, as codificações que ele dá suporte estão disponíveis chamando as sobrecargas de Encoding.GetEncoding; você não deve chamar as EncodingProvider.GetEncoding sobrecargas.

Impacto no comportamento de codificação padrão

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

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

Quando nenhum provedor de codificação é registrado, GetEncoding(0) retorna UTF-8 em todas as plataformas no .NET Core e versões posteriores.