EncoderFallbackBuffer.Fallback Метод

Определение

Пространство имен:

System.Text

Сборка:

System.Runtime.dll

Указывает, что замещающая строка доступна, если исходная входная последовательность не может быть закодирована или если исходная входная последовательность должна быть проигнорирована.

Перегрузки

Fallback(Char, Int32)	При переопределении в производном классе готовит резервный буфер для обработки указанного входного символа.
Fallback(Char, Char, Int32)	При переопределении в производном классе готовит резервный буфер для обработки указанной суррогатной пары.

Fallback(Char, Int32)

Исходный код:

EncoderFallback.cs

При переопределении в производном классе готовит резервный буфер для обработки указанного входного символа.

public:
 abstract bool Fallback(char charUnknown, int index);

public abstract bool Fallback (char charUnknown, int index);

abstract member Fallback : char * int -> bool

Public MustOverride Function Fallback (charUnknown As Char, index As Integer) As Boolean

Параметры

charUnknown

Char

Входной символ.

index

Int32

Позиция индекса символа во входном буфере.

Возвращаемое значение

Boolean

true, если резервный буфер может обработать charUnknown; false, если резервный буфер игнорирует charUnknown.

Комментарии

Методы Encoding.GetBytes и Encoder.Convert вызываются Fallback(Byte[], Int32) при обнаружении неизвестного входного символа, который не может быть закодирован. Возвращаемое значение указывает, что резервный true буфер может обработать входной символ, в результате чего вызывающий метод вызывает GetNextChar метод для получения каждого символа резервного буфера. Так как он не обрабатывает отдельные символы, Fallback метод в резервном обработчике исключений создает исключение.

Fallback(Char, Char, Int32)

Исходный код:

EncoderFallback.cs

При переопределении в производном классе готовит резервный буфер для обработки указанной суррогатной пары.

public:
 abstract bool Fallback(char charUnknownHigh, char charUnknownLow, int index);

public abstract bool Fallback (char charUnknownHigh, char charUnknownLow, int index);

abstract member Fallback : char * char * int -> bool

Public MustOverride Function Fallback (charUnknownHigh As Char, charUnknownLow As Char, index As Integer) As Boolean

Параметры

charUnknownHigh

Char

Старший символ-заместитель входной пары.

charUnknownLow

Char

Младший символ-заместитель входной пары.

index

Int32

Позиция индекса суррогатной пары во входном буфере.

Возвращаемое значение

Boolean

true, если резервный буфер может обработать charUnknownHigh и charUnknownLow, false, если резервный буфер игнорирует суррогатную пару.

Комментарии

Методы Encoding.GetBytes и Encoder.Convert вызываются Fallback(Char, Char, Int32) , если они сталкиваются с суррогатной парой во входных данных. Возвращаемое значение указывает, что резервный true буфер может обработать суррогатную пару, в результате чего вызывающий метод вызывает GetNextChar метод для получения каждого символа резервного буфера. Так как он не обрабатывает отдельные символы, Fallback метод в резервном обработчике исключений создает исключение.