EncodingProvider Classe

Definição

Namespace:

System.Text

Assembly:

System.Runtime.dll

Origem:

EncodingProvider.cs

Fornece a classe base para um provedor de codificação, que por sua vez fornece codificações que não estão disponíveis em uma plataforma específica.

public ref class EncodingProvider abstract

public abstract class EncodingProvider

type EncodingProvider = class

Public MustInherit Class EncodingProvider

Herança

Object

EncodingProvider

Derivado

System.Text.CodePagesEncodingProvider

Comentários

Um provedor de codificação fornece codificações que, de outra forma, não estão disponíveis em uma plataforma de destino específica.

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 disponíveis no .NET Framework chamando o Encoding.GetEncodings método . O .NET Core, por outro lado, por padrão, 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 Unicode propriedade .

• UTF-16BE (página de código 1201), que é instanciada chamando o UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) construtor ou UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) 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 de true na chamada de método.

A partir do .NET Framework 4.6, EncodingProvider é a classe base que disponibiliza codificações indisponíveis para o .NET Framework. Isso envolve as seguintes etapas:

1. Defina uma subclasse de EncodingProvider que substitui as duas sobrecargas abstratas GetEncoding , GetEncoding(Int32) e GetEncoding(String). Essas sobrecargas retornam a codificação sem suporte pelo identificador de página de código e pelo nome. Observe que você também pode optar por retornar uma codificação padrão se o GetEncoding(Int32) método for chamado com um argumento de 0.

2. Opcionalmente, você pode substituir os métodos e virtuais GetEncoding(Int32, EncoderFallback, DecoderFallback)GetEncoding(String, EncoderFallback, DecoderFallback) . Na maioria dos casos, isso não é necessário, pois a classe base fornece uma implementação padrão.

3. Passe a EncodingProvider instância para o Encoding.RegisterProvider método para disponibilizar as codificações fornecidas pelo EncodingProvider objeto para o Common Language Runtime.

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

A Biblioteca de Classes .NET Framework fornece uma propriedade estática, CodePagesEncodingProvider.Instance, que retorna um EncodingProvider objeto que disponibiliza o conjunto completo de codificações na biblioteca de classes de .NET Framework da área de trabalho disponível para aplicativos .NET Core. Além disso, você pode derivar da EncodingProvider classe para disponibilizar suas próprias codificações.

Construtores

EncodingProvider()

Inicializa uma nova instância da classe EncodingProvider.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEncoding(Int32)	Retorna a codificação associada ao identificador de página de código especificado.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Retorna a codificação associada ao identificador de página de código especificado. Os parâmetros especificam um manipulador de erro para caracteres que não podem ser codificados e sequências de bytes que não podem ser decodificadas.
GetEncoding(String)	Retorna a codificação com o nome especificado.
GetEncoding(String, EncoderFallback, DecoderFallback)	Retorna a codificação associada ao nome especificado. Os parâmetros especificam um manipulador de erro para caracteres que não podem ser codificados e sequências de bytes que não podem ser decodificadas.
GetEncodings()	Retorna uma matriz que contém todas as codificações compatíveis com EncodingProvider.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• GetEncoding(String)
• Instance