EncodingProvider Clase

Definición

Proporciona la clase base de un proveedor de codificación, que suministra las codificaciones que no están disponibles en una plataforma concreta.Provides the base class for an encoding provider, which supplies encodings that are unavailable on a particular platform.

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
Herencia
EncodingProvider
Derivado
Atributos

Comentarios

Un proveedor de codificación proporciona codificaciones que no están disponibles de otra manera en una plataforma de destino determinada.An encoding provider supplies encodings that are not otherwise available on a particular target platform.

El .NET Framework en el escritorio de Windows admite un gran número de codificaciones de caracteres y páginas de códigos.The .NET Framework on the Windows desktop supports a large number of character encodings and code pages. Puede obtener una lista completa de las codificaciones disponibles en el .NET Framework en el escritorio de Windows mediante una llamada al Encoding.GetEncodings método.You can get a complete list of encodings available in the .NET Framework on the Windows desktop by calling the Encoding.GetEncodings method. .NET Core, por otro lado, de forma predeterminada solo admite las codificaciones siguientes:.NET Core, on the other hand, by default supports only the following encodings:

A partir de la .NET Framework 4,6, EncodingProvider es la clase base que hace que las codificaciones no disponibles de otra manera estén disponibles para el .NET Framework.Starting with the .NET Framework 4.6, EncodingProvider is the base class that makes otherwise unavailable encodings available to the .NET Framework. Esto implica los pasos siguientes:This involves the following steps:

  1. Defina una subclase de EncodingProvider que invalide las dos GetEncoding sobrecargas abstractas, GetEncoding(Int32) y GetEncoding(String) .Define a subclass of EncodingProvider that overrides the two abstract GetEncoding overloads, GetEncoding(Int32) and GetEncoding(String). Estas sobrecargas devuelven la codificación no compatible de otro modo por el identificador de la página de códigos y por el nombre.These overloads return the otherwise unsupported encoding by code page identifier and by name. Tenga en cuenta que también puede devolver una codificación predeterminada si GetEncoding(Int32) se llama al método con un 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, puede invalidar los GetEncoding(Int32, EncoderFallback, DecoderFallback) métodos virtuales y GetEncoding(String, EncoderFallback, DecoderFallback) .Optionally, you can override the virtual GetEncoding(Int32, EncoderFallback, DecoderFallback) and GetEncoding(String, EncoderFallback, DecoderFallback) methods. En la mayoría de los casos, esto no es necesario, ya que la clase base proporciona una implementación predeterminada.In most cases, this is not necessary, since the base class provides a default implementation.

  3. Pase la EncodingProvider instancia al Encoding.RegisterProvider método para que las codificaciones proporcionadas por el EncodingProvider objeto estén disponibles para el 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. Llame Encoding.GetEncoding a una sobrecarga para recuperar la codificación.Call an Encoding.GetEncoding overload to retrieve the encoding. El Encoding.GetEncoding método llamará al correspondiente EncodingProvider.GetEncoding para determinar si puede proporcionar la codificación solicitada.The Encoding.GetEncoding method will call the corresponding EncodingProvider.GetEncoding to determine whether it can supply the requested encoding.

La biblioteca de clases de .NET Framework proporciona una propiedad estática, CodePagesEncodingProvider.Instance , que devuelve un EncodingProvider objeto que hace que todo el conjunto de codificaciones esté disponible en el escritorio .NET Framework biblioteca de clases disponible para las aplicaciones de .net Core.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 applications. Además, puede derivar de la EncodingProvider clase para que sus propias codificaciones estén disponibles.In addition, you can derive from the EncodingProvider class to make your own encodings available.

Constructores

EncodingProvider()

Inicializa una nueva instancia de la clase EncodingProvider.Initializes a new instance of the EncodingProvider class.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetEncoding(Int32)

Devuelve la codificación asociada al identificador de página de códigos especificado.Returns the encoding associated with the specified code page identifier.

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Devuelve la codificación asociada al identificador de página de códigos especificado.Returns the encoding associated with the specified code page identifier. Los parámetros especifican un controlador de errores para los caracteres que no se pueden codificar y para las secuencias de bytes que no se pueden descodificar.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncoding(String)

Devuelve la codificación con el nombre especificado.Returns the encoding with the specified name.

GetEncoding(String, EncoderFallback, DecoderFallback)

Devuelve la codificación asociada con el nombre especificado.Returns the encoding associated with the specified name. Los parámetros especifican un controlador de errores para los caracteres que no se pueden codificar y para las secuencias de bytes que no se pueden descodificar.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncodings()

Devuelve una matriz que contiene todas las codificaciones admitidas por EncodingProvider.Returns an array that contains all the encodings that are supported by the EncodingProvider.

GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también