DecoderFallbackBuffer 类

定义

public ref class DecoderFallbackBuffer abstract

public abstract class DecoderFallbackBuffer

type DecoderFallbackBuffer = class

Public MustInherit Class DecoderFallbackBuffer

继承

Object

DecoderFallbackBuffer

派生

System.Text.DecoderExceptionFallbackBuffer

System.Text.DecoderReplacementFallbackBuffer

注解

编码定义 Unicode 字符和编码的字节序列之间的映射。 如果未为特定字节序列定义映射，则将输入字节序列转换为输出字符的解码操作将失败。

如果无法执行转换，.NET Framework会提供一种故障处理机制，称为回退。 所有解码器回退处理程序都必须实现以下各项：

• 解码器回退，由派生自 类的 DecoderFallback 类表示。

• 解码器回退缓冲区，由派生自 DecoderFallbackBuffer 类的类型表示，该类可将字符串返回到转换操作。

回退可以使用三种策略来处理转换失败：

• 最适合的映射。 解码器回退缓冲区可以返回表示输入字节序列的近似值的字符串。 .NET Framework不提供最适合的公共DecoderFallbackBuffer实现。

• 替代功能的 Server Profiler。 解码器回退缓冲区可以返回字符串，例如问号 (“？”) ，指示无法解码字节序列。 在.NET Framework中， DecoderReplacementFallback 和 DecoderReplacementFallbackBuffer 类提供公共替换回退缓冲区实现。 类的 DecoderReplacementFallback 构造函数使你能够定义替换字符串。

• 异常。 实现 DecoderFallbackBuffer 将引发异常，指示无法解码字节序列，并终止解码操作。 在这种情况下，回退处理程序必须提供 DecoderFallbackBuffer 实现，尽管它不会向解码器返回字符串。 在.NET Framework中DecoderExceptionFallback， 和 DecoderExceptionFallbackBuffer 类提供一个公共异常回退实现，该实现在无法解码字节序列时引发 DecoderFallbackException 。

实现中的 DecoderFallbackBuffer 缓冲区表示要返回给解码器以响应解码器回退的整个字符串。 通常，实现还包括状态信息，例如要返回到解码器的下一个字符的索引以及要返回的剩余字符数。 由于 DecoderFallbackBuffer 是抽象类，因此它要求派生类至少实现以下成员：

• 方法 Fallback ，解码器在无法解码字节序列时调用该方法。 解码器将两条信息传递给回退缓冲区实现：包含无法解码的字节的数组和输入字节数组中第一个字节的索引。 在解码器回退异常处理程序中，将在此方法中引发异常。 否则，如果方法提供回退，则返回 true ，否则 false 返回 。

• 方法 GetNextChar ，如果 Fallback 方法返回 true，则解码器会重复调用该方法。 在连续调用中，处理程序应返回其缓冲区中的每个字符。 返回所有字符后，应返回 U+0000。 异常回退处理程序始终返回 U+0000。

• 方法 MovePrevious ，该方法尝试将指针移动到缓冲区中的上一个位置，并指示移动是否成功。 异常处理程序始终返回 false。

• 属性 Remaining ，指示要返回到解码器的剩余字符数。 异常回退处理程序始终返回零。

另请参阅

• DecoderFallback
• .NET Framework 中的字符编码