EncoderExceptionFallbackBuffer::Fallback Method (Char, Char, Int32)

 

Throws an exception because the input character cannot be encoded. Parameters specify the value and index position of the surrogate pair in the input, and the nominal return value is not used.

Namespace:   System.Text
Assembly:  mscorlib (in mscorlib.dll)

public:
virtual bool Fallback(
	wchar_t charUnknownHigh,
	wchar_t charUnknownLow,
	int index
) override

Parameters

charUnknownHigh
Type: System::Char

The high surrogate of the input pair.

charUnknownLow
Type: System::Char

The low surrogate of the input pair.

index
Type: System::Int32

The index position of the surrogate pair in the input buffer.

Return Value

Type: System::Boolean

None. No value is returned because the Fallback method always throws an exception.

Exception Condition
EncoderFallbackException

The character represented by charUnknownHigh and charUnknownLow cannot be encoded.

ArgumentOutOfRangeException

Either charUnknownHigh or charUnknownLow is invalid. charUnknownHigh is not between U+D800 and U+DBFF, inclusive, or charUnknownLow is not between U+DC00 and U+DFFF, inclusive.

The GetBytes and Convert methods call Fallback if they encounter a surrogate pair in their input. In response, Fallback always throws an exception.

.NET Framework
Available since 2.0
Return to top
Show: