MatchException 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
丟出表示模式匹配意外失敗。
[Android.Runtime.Register("java/lang/MatchException", ApiSince=36, DoNotGenerateAcw=true)]
public sealed class MatchException : Java.Lang.RuntimeException
[<Android.Runtime.Register("java/lang/MatchException", ApiSince=36, DoNotGenerateAcw=true)>]
type MatchException = class
inherit RuntimeException
- 繼承
- 屬性
備註
丟出表示模式匹配意外失敗。
MatchException 當一個窮舉模式匹配語言結構(例如表達式 switch )在執行時遇到與任何指定模式不匹配的值時,即使該結構已被認定為窮盡,也可能拋出。 這是刻意為之,可能由多種情況產生:
<ul><li>分離編譯異常,即模式所參考的型別階層部分已被更改,但模式匹配結構尚未重新編譯。 例如,如果密封介面在執行時允許的子型別集合與編譯時不同,或 enum 類別在執行時的列舉常數集合與編譯時不同,或編譯時與執行時的型別階層以不相容的方式改變。</李>
<
>
null LI 值與包含封閉類別的巢狀模式。 例如,若介面 I 包含 sealed 兩個允許的子類別 A 和 B,且記錄類別 R 有一個類型 I為的單一成分,則兩個記錄模式 R(A a) 和 R(B b) 合計被視為類型 的窮盡, R但這兩個模式都不會與 的 new R(null)結果相匹配。</李>
<LI>null 值與巢狀記錄模式。 給定一個記錄類別 S ,其單一組件為 T,其中 T 是另一個具有單一組件 String的記錄類別,則巢狀記錄模式 R(S(var s)) 被視為該類型 R 的完整,但它與 的 new R(null) 結果不匹配(而與 的結果 new R(new S(null)) 相符)。</li></ul>
MatchException 也可能在將數值與模式進行模式匹配過程中拋出。 例如,涉及記錄模式的模式匹配可能需要隱式呼叫存取器方法以提取元件值。 若任一這些存取器方法拋出例外,模式匹配會突然完成並拋出 MatchException。 原始例外將被設定為 Throwable#getCause() causeMatchException。 不 Throwable#addSuppressed(java.lang.Throwable) suppressed 記錄任何例外。
新增21。
Java 文件 java.lang.MatchException。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| MatchException(String, Throwable) |
構造出具有指定細節訊息與原因的 。 |
欄位
| 名稱 | Description |
|---|---|
| is_generated |
|
屬性
| 名稱 | Description |
|---|---|
| Cause |
回傳此擲物的原因,或 |
| Class |
取得這個丟棄物的執行時類別。 (繼承來源 Throwable) |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Throwable) |
| JavaStackTrace |
它會從 Throwable 擷取 Java 堆疊追蹤。 (繼承來源 JavaException) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Throwable) |
| JniManagedPeerState |
取得執行時最後指派的狀態旗標。 (繼承來源 JavaException) |
| JniPeerMembers |
取得用於調用此 Java 節點成員的 JNI 元資料。 |
| LocalizedMessage |
建立這個投擲物的在地描述。 (繼承來源 Throwable) |
| Message |
回傳此投擲物的詳細訊息字串。 (繼承來源 Throwable) |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Throwable) |
| StackTrace |
會得到這個丟棄物堆疊追蹤的字串表示。 (繼承來源 Throwable) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 (繼承來源 RuntimeException) |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 (繼承來源 RuntimeException) |
方法
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
標記此節點為處置,並以 |
| IJavaPeerable.Finalized() |
標記此節點為處置,並以 |
| IJavaPeerable.JniObjectReferenceControlBlock |
取得此對等端使用的原生控制區塊指標。 (繼承來源 JavaException) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
儲存執行時提供的身份雜湊碼。 (繼承來源 JavaException) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
取代儲存的受管理對等狀態旗標。 (繼承來源 JavaException) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。 (繼承來源 JavaException) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
重用相容的受管理對等端或取得請求型態的包裝器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |