EncodingProvider Classe

Definição

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.Provides the base class for an encoding provider, which supplies encodings that are unavailable on a particular platform.

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

Comentários

Um provedor de codificação fornece codificações que não estão disponíveis de outra forma em uma plataforma de destino específica.An encoding provider supplies encodings that are not otherwise available on a particular target platform.

O .NET Framework na área de trabalho do Windows dá suporte a um grande número de codificações de caracteres e páginas de código.The .NET Framework on the Windows desktop supports a large number of character encodings and code pages. Você pode obter uma lista completa de codificações disponíveis no .NET Framework na área de trabalho do Windows chamando o método Encoding.GetEncodings.You can get a complete list of encodings available in the .NET Framework on the Windows desktop by calling the Encoding.GetEncodings method. Por outro lado, o .NET Core, por padrão, dá suporte apenas às seguintes codificações:.NET Core, on the other hand, by default supports only the following encodings:

A partir do .NET Framework 4,6, EncodingProvider é a classe base que torna codificações indisponíveis de outra forma disponíveis para o .NET Framework.Starting with the .NET Framework 4.6, EncodingProvider is the base class that makes otherwise unavailable encodings available to the .NET Framework. Isso envolve as seguintes etapas:This involves the following steps:

  1. Defina uma subclasse de EncodingProvider que substitua as duas sobrecargas de GetEncoding abstratas, GetEncoding(Int32) e GetEncoding(String).Define a subclass of EncodingProvider that overrides the two abstract GetEncoding overloads, GetEncoding(Int32) and GetEncoding(String). Essas sobrecargas retornam a codificação sem suporte por identificador de página de código e por nome.These overloads return the otherwise unsupported encoding by code page identifier and by name. Observe que você também pode optar por retornar uma codificação padrão se o método GetEncoding(Int32) for chamado com um argumento de 0.Note that you can also choose to return a default encoding if the GetEncoding(Int32) method is called with an argument of 0.

  2. Opcionalmente, você pode substituir o GetEncoding(Int32, EncoderFallback, DecoderFallback) virtual e os métodos de GetEncoding(String, EncoderFallback, DecoderFallback).Optionally, you can override the virtual GetEncoding(Int32, EncoderFallback, DecoderFallback) and GetEncoding(String, EncoderFallback, DecoderFallback) methods. Na maioria dos casos, isso não é necessário, pois a classe base fornece uma implementação padrão.In most cases, this is not necessary, since the base class provides a default implementation.

  3. Passe a instância de EncodingProvider para o método Encoding.RegisterProvider para tornar as codificações fornecidas pelo objeto EncodingProvider disponíveis para o Common Language Runtime.Pass the EncodingProvider instance to the Encoding.RegisterProvider method to make the encodings supplied by the EncodingProvider object available to the common language runtime.

  4. Chame uma sobrecarga de Encoding.GetEncoding para recuperar a codificação.Call an Encoding.GetEncoding overload to retrieve the encoding. O método Encoding.GetEncoding chamará o EncodingProvider.GetEncoding correspondente para determinar se ele pode fornecer a codificação solicitada.The Encoding.GetEncoding method will call the corresponding EncodingProvider.GetEncoding to determine whether it can supply the requested encoding.

A biblioteca de classes de .NET Framework fornece uma propriedade estática, CodePagesEncodingProvider.Instance, que retorna um objeto EncodingProvider que torna o conjunto completo de codificações disponíveis na área de trabalho .NET Framework biblioteca de classes disponível para .NET Core.NET Core aplicativos.The .NET Framework Class Library provides one static property, CodePagesEncodingProvider.Instance, that returns an EncodingProvider object that makes the full set of encodings available on the desktop .NET Framework Class Library available to .NET Core.NET Core applications. Além disso, você pode derivar da classe EncodingProvider para disponibilizar suas próprias codificações.In addition, you can derive from the EncodingProvider class to make your own encodings available.

Construtores

EncodingProvider()

Inicializa uma nova instância da classe EncodingProvider.Initializes a new instance of the EncodingProvider class.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetEncoding(Int32)

Retorna a codificação associada ao identificador de página de código especificado.Returns the encoding associated with the specified code page identifier.

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Retorna a codificação associada ao identificador de página de código especificado.Returns the encoding associated with the specified code page identifier. 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.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncoding(String)

Retorna a codificação com o nome especificado.Returns the encoding with the specified name.

GetEncoding(String, EncoderFallback, DecoderFallback)

Retorna a codificação associada ao nome especificado.Returns the encoding associated with the specified name. 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.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a

Veja também