EncoderExceptionFallbackBuffer.Fallback 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
因為無法編碼輸入字元,所以擲回例外狀況。 不會使用名義上的傳回值。
多載
Fallback(Char, Int32) |
因為無法編碼輸入字元,所以擲回例外狀況。 參數會針對無法轉換的字元指定值和索引位置。 |
Fallback(Char, Char, Int32) |
因為無法編碼輸入字元,所以擲回例外狀況。 參數在輸入中會指定 Surrogate 字組的值和索引位置,且不會使用名義上的傳回值。 |
Fallback(Char, Int32)
因為無法編碼輸入字元,所以擲回例外狀況。 參數會針對無法轉換的字元指定值和索引位置。
public:
override bool Fallback(char charUnknown, int index);
public override bool Fallback (char charUnknown, int index);
override this.Fallback : char * int -> bool
Public Overrides Function Fallback (charUnknown As Char, index As Integer) As Boolean
參數
- charUnknown
- Char
輸入字元。
- index
- Int32
輸入緩衝區中字元的索引位置。
傳回
無。 因為 Fallback(Char, Int32) 方法永遠都會擲回例外狀況,所以不會傳回任何值。
例外狀況
無法編碼 charUnknown
。 此方法永遠都會擲回例外狀況,報告 charUnknown
和 index
參數的值。
備註
如果 和 Convert 方法在其輸入中遇到未知字元,則會 GetBytes 呼叫 Fallback 。 在回應中, Fallback 一律會擲回 EncoderFallbackException 。
適用於
Fallback(Char, Char, Int32)
因為無法編碼輸入字元,所以擲回例外狀況。 參數在輸入中會指定 Surrogate 字組的值和索引位置,且不會使用名義上的傳回值。
public:
override bool Fallback(char charUnknownHigh, char charUnknownLow, int index);
public override bool Fallback (char charUnknownHigh, char charUnknownLow, int index);
override this.Fallback : char * char * int -> bool
Public Overrides Function Fallback (charUnknownHigh As Char, charUnknownLow As Char, index As Integer) As Boolean
參數
- charUnknownHigh
- Char
輸入字組的高 Surrogate。
- charUnknownLow
- Char
輸入字組的低 Surrogate。
- index
- Int32
輸入緩衝區中 Surrogate 字組的索引位置。
傳回
無。 因為 Fallback(Char, Char, Int32) 方法永遠都會擲回例外狀況,所以不會傳回任何值。
例外狀況
無法編碼由 charUnknownHigh
和 charUnknownLow
表示的字元。
charUnknownHigh
或 charUnknownLow
是無效的。
charUnknownHigh
未在 U+D800 和 U+DBFF 之間 (含頭尾),或是 charUnknownLow
未在 U+DC00 和 U+DFFF 之間 (含頭尾)。
備註
GetBytes如果 和 Convert 方法在其輸入中遇到 Surrogate 配對,則會呼叫 Fallback 。 在回應中, Fallback 一律會擲回例外狀況。