EncodingProvider Clase

Definición

Espacio de nombres:

System.Text

Ensamblado:

System.Runtime.dll

Source:

EncodingProvider.cs

Proporciona la clase base de un proveedor de codificación, que suministra las codificaciones que no están disponibles en una plataforma concreta.

public ref class EncodingProvider abstract

public abstract class EncodingProvider

type EncodingProvider = class

Public MustInherit Class EncodingProvider

Herencia

Object

EncodingProvider

Derivado

System.Text.CodePagesEncodingProvider

Comentarios

Un proveedor de codificación proporciona codificaciones que no están disponibles de otro modo en una plataforma de destino determinada.

.NET Framework admite un gran número de codificaciones de caracteres y páginas de códigos. Puede obtener una lista completa de codificaciones disponibles en .NET Framework mediante una llamada al Encoding.GetEncodings método . Por otro lado, .NET Core solo admite las siguientes codificaciones de forma predeterminada:

• ASCII (página de códigos 20127), que devuelve la Encoding.ASCII propiedad .

• ISO-8859-1 (página de códigos 28591).

• UTF-7 (página de códigos 65000), que devuelve la Encoding.UTF7 propiedad .

• UTF-8 (página de códigos 65001), que devuelve la Encoding.UTF8 propiedad .

• UTF-16 y UTF-16LE (página de códigos 1200), que devuelve la Unicode propiedad .

• UTF-16BE (página de códigos 1201), que se crea una instancia llamando al UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) constructor o UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) con un bigEndian valor de true.

• UTF-32 y UTF-32LE (página de códigos 12000), que devuelve la Encoding.UTF32 propiedad .

• UTF-32BE (página de códigos 12001), que se crea una instancia mediante una llamada a un UTF32Encoding constructor que tiene un bigEndian parámetro y proporciona un valor de true en la llamada al método.

A partir de .NET Framework 4.6, es la clase base que, de lo contrario, EncodingProvider no está disponible para .NET Framework. Esto implica los pasos siguientes:

1. Defina una subclase de EncodingProvider que invalide las dos sobrecargas abstractas GetEncoding y GetEncoding(Int32)GetEncoding(String). Estas sobrecargas devuelven la codificación no admitida por el identificador de página de códigos y por nombre. Tenga en cuenta que también puede optar por devolver una codificación predeterminada si se llama al GetEncoding(Int32) método con un argumento de 0.

2. Opcionalmente, puede invalidar los métodos y GetEncoding(String, EncoderFallback, DecoderFallback) virtualesGetEncoding(Int32, EncoderFallback, DecoderFallback). En la mayoría de los casos, esto no es necesario, ya que la clase base proporciona una implementación predeterminada.

3. Pase la EncodingProvider instancia al Encoding.RegisterProvider método para que las codificaciones proporcionadas por el EncodingProvider objeto estén disponibles para Common Language Runtime.

4. Llame a una Encoding.GetEncoding sobrecarga para recuperar la codificación. El Encoding.GetEncoding método llamará al correspondiente EncodingProvider.GetEncoding para determinar si puede proporcionar la codificación solicitada.

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 codificaciones esté disponible en la biblioteca de clases de .NET Framework de escritorio disponible para las aplicaciones de .NET Core. Además, puede derivar de la EncodingProvider clase para que sus propias codificaciones estén disponibles.

Constructores

EncodingProvider()

Inicializa una nueva instancia de la clase EncodingProvider.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetEncoding(Int32)	Devuelve la codificación asociada al identificador de página de códigos especificado.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Devuelve la codificación asociada al identificador de página de códigos especificado. 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.
GetEncoding(String)	Devuelve la codificación con el nombre especificado.
GetEncoding(String, EncoderFallback, DecoderFallback)	Devuelve la codificación asociada con el nombre especificado. 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.
GetEncodings()	Devuelve una matriz que contiene todas las codificaciones admitidas por EncodingProvider.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• GetEncoding(String)
• Instance