語言

MatchException 類別

定義

丟出表示模式匹配意外失敗。

[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)

構造出具有指定細節訊息與原因的 。MatchException

欄位

名稱 Description
is_generated

true如果此實例的執行時類型恰好Throwable為 ;否則,。 false

(繼承來源 Throwable)

屬性

名稱 Description
Cause

回傳此擲物的原因,或 null 是原因不存在或未知。

(繼承來源 Throwable)
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
AddSuppressed(Throwable)

將指定的例外附加於為提供此例外而被抑制的例外。

(繼承來源 Throwable)
Construct(JniObjectReference, JniObjectReferenceOptions)

將此對等節點的建置委派給執行時的值管理器。

(繼承來源 JavaException)
Dispose()

釋放該 Java 節點所持有的資源。

(繼承來源 Throwable)
Dispose(Boolean)

當此 Java 對等端被處置或完成時,由執行環境呼叫。 實 Throwable 作毫無作用。

(繼承來源 Throwable)
DisposeUnlessReferenced()

請求值管理器處置此對等節點,除非其映射保留該受管理實例。

(繼承來源 JavaException)
Equals(Object)

測試另一個受管理節點是否參考相同的 Java 物件。

(繼承來源 JavaException)
FillInStackTrace()

填補執行堆疊的追蹤。

(繼承來源 Throwable)
GetHashCode()

回傳物件的雜湊碼值。

(繼承來源 JavaException)
GetStackTrace()

提供程式化存取由 .#printStackTrace()

(繼承來源 Throwable)
GetSuppressed()

回傳一個陣列,包含所有被抑制的例外,通常透過 try-with-resources 陳述式來傳遞此例外。

(繼承來源 Throwable)
InitCause(Throwable)

將此拋擲 物的起因 初始化為指定的值。

(繼承來源 Throwable)
PrintStackTrace()

列印這個投擲物及其回溯到標準誤差串流。

(繼承來源 Throwable)
PrintStackTrace(PrintStream)

列印此投擲檔及其回溯至指定的列印串流。

(繼承來源 Throwable)
PrintStackTrace(PrintWriter)

列印此投擲檔及其回溯至指定的列印寫入器。

(繼承來源 Throwable)
SetHandle(IntPtr, JniHandleOwnership)

設定 Handle 屬性。

(繼承來源 Throwable)
SetJavaStackTrace(JniObjectReference)

從投擲檔中刷新擷取的 Java 堆疊追蹤。

(繼承來源 JavaException)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在控制區塊中儲存參考值,但不建立 JNI 參考副本。

(繼承來源 JavaException)
SetStackTrace(StackTraceElement[])

設定將由相關方法返回 #getStackTrace() 並列印 #printStackTrace() 的堆疊追蹤元素。

(繼承來源 Throwable)
ToString()

將此值轉換為字串。

(繼承來源 Throwable)
UnregisterFromRuntime()

將此 Java 節點從互通執行時中取消註冊。

(繼承來源 Throwable)

明確介面實作

名稱 Description
IJavaPeerable.Disposed()

標記此節點為處置,並以disposing設定為 true的呼叫Dispose。

(繼承來源 JavaException)
IJavaPeerable.Finalized()

標記此節點為處置,並以disposing設定為 false的呼叫Dispose。

(繼承來源 JavaException)
IJavaPeerable.JniObjectReferenceControlBlock

取得此對等端使用的原生控制區塊指標。

(繼承來源 JavaException)
IJavaPeerable.SetJniIdentityHashCode(Int32)

儲存執行時提供的身份雜湊碼。

(繼承來源 JavaException)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

取代儲存的受管理對等狀態旗標。

(繼承來源 JavaException)
IJavaPeerable.SetPeerReference(JniObjectReference)

當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。

(繼承來源 JavaException)

擴充方法

名稱 Description
GetJniTypeName(IJavaPeerable)

取得實例 self類型的 JNI 名稱。

JavaAs<TResult>(IJavaPeerable)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

JavaCast<TResult>(IJavaObject)

執行 Android 執行時檢查型別轉換。

JavaCast<TResult>(IJavaObject)

重用相容的受管理對等端或取得請求型態的包裝器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

適用於