UndeclaredThrowableException 類別

定義

命名空間:: Java.Lang.Reflect

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

若 InvocationHandler#invoke invoke 代理實例的方法調用拋出一個檢查過的例外（ Throwable a 無法指派到 RuntimeException 或 Error），該例外無法指派到該方法子句中宣告 throws 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。

[Android.Runtime.Register("java/lang/reflect/UndeclaredThrowableException", DoNotGenerateAcw=true)]
public class UndeclaredThrowableException : Java.Lang.RuntimeException

[<Android.Runtime.Register("java/lang/reflect/UndeclaredThrowableException", DoNotGenerateAcw=true)>]
type UndeclaredThrowableException = class
    inherit RuntimeException

繼承: Exception

JavaException

Throwable

Exception

RuntimeException
UndeclaredThrowableException

屬性: RegisterAttribute

備註

一個 UndeclaredThrowableException 實例包含由呼叫處理器拋出的未宣告檢查異常，且可用該 getUndeclaredThrowable() 方法檢索。 UndeclaredThrowableException 擴展 RuntimeException，因此它是包裹已檢查異常的未檢查例外。

自 1.4 版本起，此例外已被調整以符合通用例外鏈機制。在建構時可提供並可透過 #getUndeclaredThrowable() 該方法存取的「未宣告檢查異常」，現在被稱為原因，且可透過 Throwable#getCause() 該方法以及前述的「遺留方法」存取。

在 1.3 版本中加入。

的 java.lang.reflect.UndeclaredThrowableExceptionJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

名稱	Description
UndeclaredThrowableException(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。
UndeclaredThrowableException(Throwable, String)	構建 `UndeclaredThrowableException` 包含指定 `Throwable` 內容與詳細訊息的。
UndeclaredThrowableException(Throwable)	構造， `UndeclaredThrowableException` 具有指定的 `Throwable`。

欄位

名稱	Description
is_generated	表示此投擲物是否由綁定產生。 (繼承來源 Throwable)

屬性

名稱	Description
Cause	回傳此擲物的原因，或 `null` 是原因不存在或未知。 (繼承來源 Throwable)
Class	取得這個丟棄物的執行時類別。 (繼承來源 Throwable)
Handle	底層 Android 實例的帳號。 (繼承來源 Throwable)
JavaStackTrace	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。 (繼承來源 JavaException)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Throwable)
JniManagedPeerState	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。 (繼承來源 JavaException)
JniPeerMembers	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。
LocalizedMessage	建立這個投擲物的在地描述。 (繼承來源 Throwable)
Message	回傳此投擲物的詳細訊息字串。 (繼承來源 Throwable)
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Throwable)
StackTrace	會得到這個丟棄物堆疊追蹤的字串表示。 (繼承來源 Throwable)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
UndeclaredThrowable	回傳 `Throwable` 包裹於此 `UndeclaredThrowableException`的實例，可能為 `null`。

方法

名稱	Description
AddSuppressed(Throwable)	將指定的例外附加於為提供此例外而被抑制的例外。 (繼承來源 Throwable)
Construct(JniObjectReference, JniObjectReferenceOptions)	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。 (繼承來源 JavaException)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Throwable)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Throwable)
DisposeUnlessReferenced()	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。 (繼承來源 JavaException)
Equals(Object)	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。 (繼承來源 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)	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。 (繼承來源 JavaException)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。 (繼承來源 JavaException)
SetStackTrace(StackTraceElement[])	設定將由相關方法返回 `#getStackTrace()` 並列印 `#printStackTrace()` 的堆疊追蹤元素。 (繼承來源 Throwable)
ToString()	將此值轉換為字串。 (繼承來源 Throwable)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Throwable)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。 (繼承來源 JavaException)
IJavaPeerable.Finalized()	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。 (繼承來源 JavaException)
IJavaPeerable.JniObjectReferenceControlBlock	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。 (繼承來源 JavaException)
IJavaPeerable.SetJniIdentityHashCode(Int32)	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。 (繼承來源 JavaException)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。 (繼承來源 JavaException)
IJavaPeerable.SetPeerReference(JniObjectReference)	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。 (繼承來源 JavaException)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	若 `InvocationHandler#invoke invoke` 代理實例的方法調用拋出一個檢查過的例外（ `Throwable` a 無法指派到 `RuntimeException` 或 `Error`），該例外無法指派到該方法子句中宣告 `throws` 的任何例外類型，且該例外被調用並派遣到調用處理器，則該方法呼叫會拋出該例外。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於