語言

EnumMap 類別

定義

一個專門用於 enum 類型鍵的實 Map 作。

[Android.Runtime.Register("java/util/EnumMap", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "K extends java.lang.Enum<K>", "V" })]
public class EnumMap : Java.Util.AbstractMap, IDisposable, Java.IO.ISerializable, Java.Lang.ICloneable
[<Android.Runtime.Register("java/util/EnumMap", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K extends java.lang.Enum<K>", "V" })>]
type EnumMap = class
    inherit AbstractMap
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICloneable
    interface IMap
繼承
屬性
實作

備註

一個專門用於 enum 類型鍵的實 Map 作。 列舉映射中的所有鍵必須來自一個單一列舉類型,該類型在建立映射時明確或隱含地指定。 枚舉映射內部以陣列表示。 這種表示極為簡潔且高效。

Enum 映射依其 鍵的自然順序 (enum 常數宣告的順序)來維護。 這反映在集合視圖回傳的迭代器(#keySet()、 #entrySet()、 #values()和 )。

集合視圖回傳的迭代器一致性 很弱:它們永遠不會丟棄 ConcurrentModificationException ,且可能不會顯示迭代過程中對地圖的任何修改所產生的影響。

不允許使用空鍵。 嘗試插入空鍵會拋出 NullPointerException。 然而,嘗試測試是否有空金鑰或移除空金鑰時,功能會正常運作。 允許使用空值。

像大多數集合實作 EnumMap 一樣,並非同步。 如果多個執行緒同時存取一個列舉映射,且至少有一個執行緒修改了映射,則應在外部同步。 這通常是透過在某個自然封裝 enum 映射的物件上同步來達成。 若不存在此類物件,則應使用該 Collections#synchronizedMap 方法「包裹」映射。 此操作最好在建立時進行,以防止意外非同步存取:

Map&lt;EnumKey, V&gt; m
                    = Collections.synchronizedMap(new EnumMap&lt;EnumKey, V&gt;(...));

實作說明:所有基本操作皆以常數時間執行。 它們很可能(雖然不保證)比同類更快 HashMap 。

此類別是 Java 集合框架的成員。

已在1.5中新增。

Java 文件 java.util.EnumMap。

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

建構函式

名稱 Description
EnumMap(Class)

建立一個包含指定鍵型別的空枚舉映射。

EnumMap(EnumMap)

建立一個與指定列舉映射相同鍵型的列舉映射,初始包含相同的映射(若有的話)。

EnumMap(IDictionary)

建立由指定映射初始化的枚舉映射。

EnumMap(IntPtr, JniHandleOwnership)

用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

屬性

名稱 Description
Class

回傳此 Object的執行時類別。

(繼承來源 Object)
Handle

底層 Android 實例的帳號。

(繼承來源 Object)
IsEmpty

若此映射不含鍵值映射,則回傳為真。

(繼承來源 AbstractMap)
JniIdentityHashCode

取得由互通執行時指派給此 Java 對等端的身份雜湊碼。

(繼承來源 Object)
JniManagedPeerState

取得執行時最後指派的狀態旗標。

(繼承來源 JavaObject)
JniPeerMembers

取得用於存取此 Java 綁定成員的 JNI 元資料。

PeerReference

取得這個 Java 節點的 JNI 物件參考。

(繼承來源 Object)
ThresholdClass

此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。

ThresholdType

此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。

方法

名稱 Description
Clear()

移除此映射中的所有映射(可選操作)。

(繼承來源 AbstractMap)
Clone()

回傳這個枚舉映射的淺版本。

Construct(JniObjectReference, JniObjectReferenceOptions)

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

(繼承來源 JavaObject)
ContainsKey(Object)

若此映射包含指定鍵的映射,則回傳為真。

(繼承來源 AbstractMap)
ContainsValue(Object)

若此映射將一個或多個鍵映射到指定值,則返回為真。

(繼承來源 AbstractMap)
Dispose()

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

(繼承來源 Object)
Dispose(Boolean)

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

(繼承來源 Object)
DisposeUnlessReferenced()

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

(繼承來源 JavaObject)
EntrySet()

回傳 Set 此地圖中所包含映射的視圖。

Equals(Object)

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

(繼承來源 JavaObject)
Equals(Object)

表示是否有其他物體「等同」於此物。

(繼承來源 Object)
Get(Object)

回傳指定鍵映射的值,若該映射中沒有鍵的映射,則回傳為空值。

(繼承來源 AbstractMap)
GetHashCode()

回傳物件的雜湊碼值。

(繼承來源 Object)
JavaFinalize()
已淘汰.

當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。

(繼承來源 Object)
KeySet()

回傳此映射中所含鍵的集合視圖。

(繼承來源 AbstractMap)
Notify()

喚醒一個正在該物件監視器上等待的執行緒。

(繼承來源 Object)
NotifyAll()

喚醒所有等待該物件監視器的執行緒。

(繼承來源 Object)
Put(Object, Object)

將指定值與此映射中的指定鍵鍵關聯(可選操作)。

(繼承來源 AbstractMap)
PutAll(IDictionary)

將指定映射中的所有映射複製到該映射(可選操作)。

(繼承來源 AbstractMap)
Remove(Object)

若該映射存在,則移除該映射(可選操作)。

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

設定 Handle 屬性。

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

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

(繼承來源 JavaObject)
Size()

回傳此映射中鍵值映射的數量。

(繼承來源 AbstractMap)
ToArray<T>()

從這個 Java 陣列包裝器建立一個受管理陣列。

(繼承來源 Object)
ToString()

回傳物件的字串表示。

(繼承來源 Object)
UnregisterFromRuntime()

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

(繼承來源 Object)
Values()

回傳此映射中所含值的集合檢視。

(繼承來源 AbstractMap)
Wait()

導致目前執行緒等待被喚醒,通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。

(繼承來源 Object)
Wait(Int64, Int32)

會讓目前執行緒等待喚醒,通常是透過 <em>通知</><em 或 em>中斷</em>,或是經過一定的真實時間。

(繼承來源 Object)
Wait(Int64)

會讓目前執行緒等待喚醒,通常是透過 <em>通知</><em 或 em>中斷</em>,或是經過一定的真實時間。

(繼承來源 Object)

明確介面實作

名稱 Description
IJavaPeerable.Disposed()

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

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

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

(繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

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

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

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

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

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

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

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

(繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

將此實例從執行時的 Java 物件查詢中移除。

擴充方法

名稱 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 端是否有效。

適用於