DecoderFallback (Clase)

Una codificación asigna un carácter Unicode a una secuencia de bytes codificada. Un tipo que se deriva de la clase Encoding representa una codificación determinada. Específicamente, un carácter se codifica en una secuencia de bytes llamando al método Encoding.GetBytes(String) del tipo de codificación y la secuencia de bytes se descodifica en una matriz de caracteres o una cadena llamando al método Encoding.GetString(Byte[]) o Encoding.GetChars(Byte[]).

Una operación de descodificación puede producir errores si la codificación no puede asignar la secuencia de bytes de entrada. Por ejemplo, un objeto ASCIIEncoding no puede descodificar una secuencia de bytes si representa un carácter cuyo valor de punto de código se encuentra fuera del intervalo de U+0000 a U+007F.

Cuando no se puede realizar una conversión de descodificación, .NET Framework proporciona un mecanismo de control de errores denominado reserva. La aplicación puede usar las reservas del descodificador predefinidas de .NET Framework o puede crear una personalizada derivada de las clases DecoderFallback y DecoderFallbackBuffer.

DecoderFallback y DecoderFallbackBuffer son las clases base para todos los controladores de retroceso de descodificación en .NET Framework. Admiten los siguientes tres tipos de mecanismos de control de reserva:

• Retroceso mejor encajado, que asigna caracteres Unicode válidos que no se pueden descodificar en un equivalente aproximado. Por ejemplo, un controlador del retroceso mejor ajustado para la clase ASCIIEncoding podría asignar Æ (U+00C6) a CA (U+0041 + U+0045). Un controlador de retroceso de ajuste perfecto también se puede implementar para transcribir un alfabeto (como el cirílico) a otro (como el latino o el romano). .NET Framework no proporciona ninguna mejor implementación de retroceso pública.

• Reserva de reemplazo, que reemplaza cada carácter que no se puede descodificar por una cadena predefinida. .NET Framework proporciona un controlador de retroceso de reemplazo predefinido. La clase DecoderReplacementFallback reemplaza cada secuencia de bytes que no se puede descodificar por un carácter de signo de interrogación ("?" o U+003F) o un CARÁCTER DE REEMPLAZO (U+FFFD). Puede personalizar la cadena de reemplazo especificando un suplente en la llamada al constructor DecoderReplacementFallback.DecoderReplacementFallback(String). Una vez emitida la cadena de sustitución, se prosigue con la operación de descodificación del resto de la entrada.

• Un controlador de retroceso de excepción, que produce una excepción cuando no se puede descodificar una secuencia de bytes. .NET Framework proporciona un controlador de retroceso de excepción predefinido. La clase DecoderExceptionFallback produce DecoderFallbackException cuando se encuentra una secuencia de bytes no válida, y la operación de descodificación finaliza.

Si decide implementar una solución personalizada, debe invalidar los siguientes miembros abstractos de la clase DecoderFallback:

• El método CreateFallbackBuffer, que devuelve una instancia de clase derivada de DecoderFallbackBuffer. Dependiendo del tipo de controlador de reserva que está desarrollando, la implementación de DecoderFallbackBuffer es responsable de realizar la asignación o el reemplazo, o de producir la excepción.

• La propiedad MaxCharCount, que devuelve el número de caracteres máximo que la implementación de reserva puede devolver. Para un controlador de retroceso de excepción, su valor debería ser cero.

Para obtener más información sobre cómo codificar, descodificar y estrategias de retroceso, vea Codificación de caracteres en .NET Framework.

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Referencia

Otros recursos