EncoderFallback Clase

Definición

Proporciona un mecanismo de control de errores, denominado reserva, para un carácter de entrada que no puede convertirse en una secuencia codificada de bytes de salida.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an encoded output byte sequence.

public ref class EncoderFallback abstract
public abstract class EncoderFallback
[System.Serializable]
public abstract class EncoderFallback
type EncoderFallback = class
Public MustInherit Class EncoderFallback
Herencia
EncoderFallback
Derivado
Atributos

Comentarios

Una codificación asigna un carácter Unicode a una secuencia de bytes codificada.An encoding maps a Unicode character to an encoded sequence of bytes. Un tipo que se deriva de la clase Encoding representa una codificación determinada.A particular encoding is represented by a type that is derived from the Encoding class. En concreto, un carácter se codifica en una secuencia de bytes llamando al método Encoding.GetBytes del tipo de codificación y la secuencia de bytes se descodifica en una matriz de caracteres o en una cadena mediante una llamada al método Encoding.GetChars o Encoding.GetString.Specifically, a character is encoded to a byte sequence by calling the encoding type's Encoding.GetBytes method, and the byte sequence is decoded to a character array or a string by calling the Encoding.GetChars or Encoding.GetString method.

Se puede producir un error en una operación de codificación si la codificación no puede representar el carácter de entrada.An encoding operation can fail if the input character cannot be represented by the encoding. Por ejemplo, un objeto ASCIIEncoding no puede codificar un carácter cuyo valor de punto de código Unicode esté fuera del intervalo de U + 0000 a U + 007F.For example, an ASCIIEncoding object cannot encode a character whose Unicode code point value is outside the range U+0000 to U+007F.

Cuando no se puede realizar una conversión de codificación, el .NET Framework proporciona un mecanismo de control de errores denominado reserva.When an encoding conversion cannot be performed, the .NET Framework provides a failure-handling mechanism called a fallback. La aplicación puede usar reservas de codificador .NET Framework predefinidas o puede crear una reserva de codificador personalizada derivada de las clases EncoderFallback y EncoderFallbackBuffer.Your application can use predefined .NET Framework encoder fallbacks, or it can create a custom encoder fallback derived from the EncoderFallback and EncoderFallbackBuffer classes.

EncoderFallback y EncoderFallbackBuffer son las clases base para todos los controladores de reserva de codificación de la .NET Framework.EncoderFallback and EncoderFallbackBuffer are the base classes for all encoding fallback handlers in the .NET Framework. Admiten los tres tipos siguientes de mecanismos de control de reserva:They support the following three kinds of fallback handling mechanisms:

  • Reserva con ajuste perfecto, que asigna caracteres Unicode válidos que no se pueden codificar a un equivalente aproximado.Best-fit fallback, which maps valid Unicode characters that cannot be encoded to an approximate equivalent. Por ejemplo, un controlador de reserva con ajuste perfecto para la clase ASCIIEncoding podría asignar Æ (U + 00C6) a AE (U + 0041 + U + 0045).For example, a best-fit fallback handler for the ASCIIEncoding class might map Æ (U+00C6) to AE (U+0041 + U+0045). También se puede implementar un controlador de reserva con ajuste perfecto para transcribir un alfabeto (como el cirílico) a otro (como Latin o Roman).A best-fit fallback handler might also be implemented to transliterate one alphabet (such as Cyrillic) to another (such as Latin or Roman). El .NET Framework no proporciona ninguna implementación de reserva con ajuste perfecto público.The .NET Framework does not provide any public best-fit fallback implementations.

  • Reserva de reemplazo, que reemplaza cada carácter que no se puede codificar con una cadena predefinida.Replacement fallback, which replaces each character that cannot be encoded with a predefined string. El .NET Framework proporciona un controlador de reserva de reemplazo predefinido.The .NET Framework provides a predefined replacement fallback handler. La clase EncoderReplacementFallback reemplaza cada secuencia de bytes que no se puede descodificar con un carácter de signo de interrogación ("?", u U + 003F) o un carácter de reemplazo (U + FFFD).The EncoderReplacementFallback class replaces each byte sequence that cannot be decoded with a question mark character ("?", or U+003F) or a REPLACEMENT CHARACTER (U+FFFD). Puede personalizar la cadena de reemplazo especificando un sustituto en la llamada al constructor de EncoderReplacementFallback.EncoderReplacementFallback(String).You can customize the replacement string by specifying a substitute in the call to the EncoderReplacementFallback.EncoderReplacementFallback(String) constructor. Una vez emitida la cadena de sustitución, la operación de codificación continúa convirtiendo el resto de la entrada.After the substitute string is emitted, the encoding operation continues converting the remainder of the input.

  • Reserva de excepción, que produce una excepción cuando no se puede codificar un carácter.Exception fallback, which throws an exception when a character cannot be encoded. El .NET Framework proporciona un controlador de reserva de excepción predefinido.The .NET Framework provides a predefined exception fallback handler. La clase EncoderExceptionFallback inicia una EncoderFallbackException cuando se encuentra un carácter no válido y finaliza la operación de codificación.The EncoderExceptionFallback class throws an EncoderFallbackException when an invalid character is encountered, and the encoding operation terminates.

Si decide implementar una solución personalizada, debe invalidar los siguientes miembros abstractos de la clase EncoderFallback:If you choose to implement a custom solution, you must override the following abstract members of the EncoderFallback class:

  • El método CreateFallbackBuffer, que devuelve una instancia de clase derivada de EncoderFallbackBuffer.The CreateFallbackBuffer method, which returns a class instance derived from EncoderFallbackBuffer. En función del tipo de controlador de reserva que esté desarrollando, la EncoderFallbackBuffer implementación es responsable de realizar la asignación o el reemplazo, o de producir la excepción.Depending on the type of fallback handler that you are developing, the EncoderFallbackBuffer implementation is responsible for performing the mapping or replacement, or for throwing the exception.

  • La propiedad MaxCharCount, que devuelve el número máximo de caracteres que puede devolver la implementación de reserva.The MaxCharCount property, which returns the maximum number of characters that the fallback implementation can return. Para un controlador de reserva de excepción, su valor debe ser cero.For an exception fallback handler, its value should be zero.

Para obtener más información sobre la codificación, la descodificación y las estrategias de reserva, vea codificación de caracteres en el .NET Framework.For more information about encoding, decoding, and fallback strategies, see Character Encoding in the .NET Framework.

Constructores

EncoderFallback()

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

Propiedades

ExceptionFallback

Obtiene un objeto que produce una excepción cuando no se puede codificar un carácter de entrada.Gets an object that throws an exception when an input character cannot be encoded.

MaxCharCount

Cuando se invalida en una clase derivada, obtiene el número máximo de caracteres que puede devolver el objeto EncoderFallback actual.When overridden in a derived class, gets the maximum number of characters the current EncoderFallback object can return.

ReplacementFallback

Obtiene un objeto que genera una cadena de sustitución de un carácter de entrada que no se puede codificar.Gets an object that outputs a substitute string in place of an input character that cannot be encoded.

Métodos

CreateFallbackBuffer()

Cuando se reemplaza en una clase derivada, inicializa una nueva instancia de la clase EncoderFallbackBuffer.When overridden in a derived class, initializes a new instance of the EncoderFallbackBuffer class.

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)
GetHashCode()

Sirve como 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 objeto 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: