EncodingProvider Classe

Definição

Espaço de Nomes:
System.Text
Assemblagens:
mscorlib.dll, System.Text.Encoding.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Text.Encoding.dll
Assemblagem:
netstandard.dll

Fornece a classe base para um fornecedor de codificação, que fornece codificações que não estão disponíveis numa determinada plataforma.

public ref class EncodingProvider abstract
public abstract class EncodingProvider
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EncodingProvider
type EncodingProvider = class
[<System.Runtime.InteropServices.ComVisible(true)>]
type EncodingProvider = class
Public MustInherit Class EncodingProvider
Herança
Object
EncodingProvider
Atributos
ComVisibleAttribute

Observações

Um fornecedor de codificação fornece codificações que de outra forma não estão disponíveis numa determinada plataforma-alvo.

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

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

A partir do .NET Framework 4.6, EncodingProvider é a classe base que disponibiliza codificações que de outra forma não estavam disponíveis para o .NET Framework. Isso envolve as seguintes etapas:

  1. Defina-se uma subclasse de EncodingProvider que sobrepõe as duas sobrecargas abstratas GetEncoding , GetEncoding(Int32) e GetEncoding(String). Estas sobrecargas devolvem a codificação, de outra forma, não suportada por identificador de página de códigos e por nome. Note que também pode optar por devolver uma codificação por defeito se o GetEncoding(Int32) método for chamado com um argumento 0.

  2. Opcionalmente, pode sobrepor o virtual GetEncoding(Int32, EncoderFallback, DecoderFallback) e GetEncoding(String, EncoderFallback, DecoderFallback) métodos. Na maioria dos casos, isto não é necessário, pois a classe base fornece uma implementação padrão.

  3. Passar a EncodingProvider instância para o Encoding.RegisterProvider método para tornar as codificações fornecidas pelo EncodingProvider objeto disponíveis para o runtime da linguagem comum.

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

.NET Biblioteca de Classes Framework fornece uma propriedade estática, CodePagesEncodingProvider.Instance, que devolve um objeto EncodingProvider que torna disponível o conjunto completo de codificações na biblioteca de classes desktop .NET Framework para .NET aplicações Core. Além disso, pode derivar da EncodingProvider classe para disponibilizar as suas próprias codificações.

Construtores

Name Description
EncodingProvider()

Inicializa uma nova instância da EncodingProvider classe.

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.
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.
GetEncoding(String)

Devolve a codificação com o nome especificado.
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

Ver também