DecoderReplacementFallbackBuffer
Class
Definition
Represents a substitute output string that is emitted when the original input byte sequence cannot be decoded. This class cannot be inherited.
public sealed class DecoderReplacementFallbackBuffer : System.Text.DecoderFallbackBuffer
- Inheritance
Inherited Members
System.Object
Remarks
It might not be possible to convert an encoded byte sequence to an equivalent character if no suitable decoding exists. A common reason for a decoding to fail is that the conversion operation uses a code page that cannot represent the character to decode.
If the input byte sequence cannot be converted to an output character, a DecoderReplacementFallback object provides a replacement string that is substituted for the output character. The replacement string initializes the value of the DecoderReplacementFallback object, and the value of the DecoderReplacementFallback object initializes the value of a DecoderReplacementFallbackBuffer object. The value of a DecoderReplacementFallbackBuffer object is called the replacement fallback buffer. The conversion operation uses the replacement fallback buffer to emit a replacement string instead of a decoded character, then continues to process the remainder of the input.
Constructors
| DecoderReplacementFallbackBuffer(DecoderReplacementFallback) |
Initializes a new instance of the DecoderReplacementFallbackBuffer class using the value of a DecoderReplacementFallback object. |
Properties
| Remaining |
Gets the number of characters in the replacement fallback buffer that remain to be processed. |
Methods
| Fallback(Byte[], Int32) |
Prepares the replacement fallback buffer to use the current replacement string. |
| GetNextChar() |
Retrieves the next character in the replacement fallback buffer. |
| MovePrevious() |
Causes the next call to GetNextChar() to access the character position in the replacement fallback buffer prior to the current character position. |
| Reset() |
Initializes all internal state information and data in the DecoderReplacementFallbackBuffer object. |