EncodingProvider EncodingProvider EncodingProvider EncodingProvider Class

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
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EncodingProvider
type EncodingProvider = class
Public MustInherit Class EncodingProvider
Herencia
EncodingProviderEncodingProviderEncodingProviderEncodingProvider
Derivado
Atributos

Comentarios

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

.NET Framework en el escritorio Windows admite un gran número de caracteres codificaciones 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 codificaciones disponibles en .NET Framework en el escritorio de Windows mediante una llamada a la 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 admite solo las codificaciones siguientes:.NET Core, on the other hand, by default supports only the following encodings:

A partir de .NET Framework 4.6, EncodingProvider es la clase base que en caso contrario, dejará de estar disponible codificaciones disponibles en .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. Define una subclase de EncodingProvider que invalida la abstracta dos GetEncoding sobrecargas, 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 que el en caso contrario, una codificación no compatible por identificador de página de códigos y por 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 el 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. Si lo desea, puede invalidar el virtual GetEncoding(Int32, EncoderFallback, DecoderFallback) y GetEncoding(String, EncoderFallback, DecoderFallback) métodos.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, puesto 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 el EncodingProvider de instancia para el Encoding.RegisterProvider método para hacer que las codificaciones proporcionadas por el EncodingProvider objeto disponible para 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. Llamar a un Encoding.GetEncoding sobrecarga para recuperar la codificación.Call an Encoding.GetEncoding overload to retrieve the encoding. El Encoding.GetEncoding método llamará a la 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 el conjunto completo de las codificaciones disponibles en el escritorio de .NET Framework Class Library disponibles para Núcleo de .NET.NET Core aplicaciones.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 Núcleo de .NET.NET Core applications. Además, puede derivar el EncodingProvider clase para realizar sus propias codificaciones disponibles.In addition, you can derive from the EncodingProvider class to make your own encodings available.

Constructores

EncodingProvider() EncodingProvider() EncodingProvider() EncodingProvider()

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

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32) 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) GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback) 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) GetEncoding(String) GetEncoding(String) GetEncoding(String)

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

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Se aplica a

Consulte también: