IDeprecated 介面

定義

命名空間:

Java.Lang

組件:

Mono.Android.dll

標註 @Deprecated 的程式元素是指程式設計師不被鼓勵使用的元素。

[Android.Runtime.Register("java/lang/Deprecated", "", "Java.Lang.IDeprecatedInvoker")]
public interface IDeprecated : IDisposable, Java.Interop.IJavaPeerable, Java.Lang.Annotation.IAnnotation

[<Android.Runtime.Register("java/lang/Deprecated", "", "Java.Lang.IDeprecatedInvoker")>]
type IDeprecated = interface
    interface IAnnotation
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable IAnnotation IDisposable

備註

標註 @Deprecated 的程式元素是指程式設計師不被鼓勵使用的元素。 某個元素可能因多種原因被棄用，例如其使用可能導致錯誤;未來版本可能會被不相容地更改或移除;它已被更新且通常更理想的替代方案取代;或者已經過時。

當非棄用程式碼中使用或覆寫已棄用的程式元素時，編譯器會發出警告。 在本地變數宣告、參數宣告或套件宣告上使用 @Deprecated 註解，對編譯器發出的警告不產生影響。

當模組被棄用時，若該模組在 requires中被使用但未在 或 exports 子句中opens，會發出警告。 模組被棄用是否<>會導致<>對模組內類型使用的警告發出？

此註解類型有一個字串值元素 since。 此元素的值表示該註解程式元素首次被棄用的版本。

此註解類型有一個布林值元素 forRemoval。 值 表示 true 未來版本中有意移除註解程式元素。 值 表示 false 不建議使用註解程式元素，但在標註時並無特定移除意圖。

已在1.5中新增。

Java 文件 java.lang.Deprecated。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

屬性

名稱	Description
Handle	取得底層 Android 物件的 JNI 值。 (繼承來源 IJavaObject)
JniIdentityHashCode	回傳包裹實例的 java.lang.System.identityHashCode() 值。 (繼承來源 IJavaPeerable)
JniManagedPeerState	管理貴族的狀況。 (繼承來源 IJavaPeerable)
JniObjectReferenceControlBlock	標註 @Deprecated 的程式元素是指程式設計師不被鼓勵使用的元素。 (繼承來源 IJavaPeerable)
JniPeerMembers	成員存取與召喚支援。 (繼承來源 IJavaPeerable)
PeerReference	回傳JniObjectReference包裹後的 Java 物件實例。 (繼承來源 IJavaPeerable)

方法

名稱	Description
AnnotationType()	回傳該註解的註解介面。 (繼承來源 IAnnotation)
Disposed()	當實例被處理後才被召喚。 (繼承來源 IJavaPeerable)
DisposeUnlessReferenced()	如果沒有未解決的參考資料，則 Dispose()呼叫;否則，則不做任何事。 (繼承來源 IJavaPeerable)
Equals(Object)	若指定物件代表與此標註邏輯等價，則返回真。 (繼承來源 IAnnotation)
Finalized()	當實例完成後才會被通知。 (繼承來源 IJavaPeerable)
ForRemoval()	表示註解元素是否會在未來版本中被移除。
GetHashCode()	回傳此註解的雜湊碼。 (繼承來源 IAnnotation)
SetJniIdentityHashCode(Int32)	將回傳的值設為 JniIdentityHashCode。 (繼承來源 IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	標註 @Deprecated 的程式元素是指程式設計師不被鼓勵使用的元素。 (繼承來源 IJavaPeerable)
SetPeerReference(JniObjectReference)	將回傳的值設為 PeerReference。 (繼承來源 IJavaPeerable)
Since()	回傳註解元素被棄用的版本。
ToString()	回傳此註解的字串表示。 (繼承來源 IAnnotation)
UnregisterFromRuntime()	取消註冊此實例，讓執行時不會在未來 Java.Interop.JniRuntime+JniValueManager.PeekValue 的呼叫中回傳該實例。 (繼承來源 IJavaPeerable)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	標註 @Deprecated 的程式元素是指程式設計師不被鼓勵使用的元素。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。