Optional 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
一個容器物件，可能包含也可能不包含非null 值。
[Android.Runtime.Register("java/util/Optional", ApiSince=24, DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "T" })]
public sealed class Optional : Java.Lang.Object[<Android.Runtime.Register("java/util/Optional", ApiSince=24, DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "T" })>]
type Optional = class
inherit Object- 繼承
- 屬性
備註
一個容器物件，可能包含也可能不包含非null 值。 若存在一個值，則 isPresent() 返回 true。 若不存在值，物件視為 空 ，回 isPresent() 傳 false。
還提供了依賴於包含值是否存在的方法，例如 #orElse(Object) orElse() （若無值則回傳預設值）及 #ifPresent(Consumer) ifPresent() （若有值則執行動作）。
這是一個 以價值為基礎 的類別;程式設計師應將 #equals（物件）相等的實例視為可互換，不應使用實例進行同步，否則可能會發生不可預測的行為。 例如，在未來版本中，同步可能會失敗。
新增於1.8版本。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| IsEmpty |
若不存在某值，則返回 |
| IsPresent |
若存在某值，則返回 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
一個容器物件，可能包含也可能不包含非 |
| JniPeerMembers |
一個容器物件，可能包含也可能不包含非 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object) |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object) |
方法
| 名稱 | Description |
|---|---|
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
一個容器物件，可能包含也可能不包含非 |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
一個容器物件，可能包含也可能不包含非 |
| Empty() |
回傳一個空 |
| Equals(Object) |
一個容器物件，可能包含也可能不包含非 |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| Filter(IPredicate) |
若存在一個值，且該值與給定謂詞相符，則回傳 |
| FlatMap(IFunction) |
若存在 值，則回傳將給定 |
| Get() |
若存在值，則回傳該值，否則拋 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| IfPresent(IConsumer) |
若存在一個值，則對該值執行給定動作，否則不做任何事。 |
| IfPresentOrElse(IConsumer, IRunnable) |
若有值，則用該值執行給定動作，否則執行給定的空值動作。 |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Map(IFunction) |
若存在一個值，則回傳 |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Of(Object) |
回傳 並 |
| OfNullable(Object) |
回傳 和 |
| Or(ISupplier) |
若有值，則回傳描述 |
| OrElse(Object) |
若有值，則回傳該值，否則返回 |
| OrElseGet(ISupplier) |
若有值，則回傳該值，否則回傳由供應函數產生的結果。 |
| OrElseThrow() |
若存在值，則回傳該值，否則拋 |
| OrElseThrow(ISupplier) |
若有值存在，則回傳該值，否則拋出由例外供應函數產生的例外。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
一個容器物件，可能包含也可能不包含非 |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
一個容器物件，可能包含也可能不包含非 |
| IJavaPeerable.Finalized() |
一個容器物件，可能包含也可能不包含非 |
| IJavaPeerable.JniObjectReferenceControlBlock |
一個容器物件，可能包含也可能不包含非 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
一個容器物件，可能包含也可能不包含非 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
一個容器物件，可能包含也可能不包含非 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
一個容器物件，可能包含也可能不包含非 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
一個容器物件，可能包含也可能不包含非 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |