ArrayMap 類別

定義

命名空間:

Android.Util

組件:

Mono.Android.dll

ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。

[Android.Runtime.Register("android/util/ArrayMap", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public sealed class ArrayMap : Java.Lang.Object, IDisposable, Java.Util.IMap

[<Android.Runtime.Register("android/util/ArrayMap", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type ArrayMap = class
    inherit Object
    interface IMap
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

繼承

Object

JavaObject

Object

ArrayMap

屬性

RegisterAttribute JavaTypeParametersAttribute

實作

IJavaObject IJavaPeerable IMap IDisposable

備註

ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。 它將映射保存在陣列資料結構中——每個項目的雜湊碼整數陣列，以及鍵值對的物件陣列。 這讓它避免每次輸入到地圖的條目都必須新增一個物件，並且會更積極地控制陣列大小的成長（因為擴大陣列只需複製陣列中的條目，而非重建雜湊映射）。

請注意，此實作並不適用於可能包含大量項目的資料結構。 它通常比傳統的 HashMap 慢，因為查詢需要二元搜尋，且新增與移除則需插入或刪除陣列中的條目。 對於可容納數百件物品的容器，效能差異不大，不到 50%。

由於此容器旨在更好地平衡記憶體使用，與大多數其他標準 Java 容器不同，當項目被移除時，陣列會逐漸縮小。 目前你無法控制這個縮小——如果你設定一個容量，然後移除物品，可能會減少容量以更符合目前的大小。 未來明確設定容量應該能關閉這種積極縮水的行為。

此結構為 <b>NOT</b> 執行緒安全。

Java 文件 android.util.ArrayMap。

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

建構函式

名稱	Description
ArrayMap()	建立一個新的空 ArrayMap。
ArrayMap(ArrayMap)	用該 ArrayMap 的映射建立一個新的 ArrayMap。
ArrayMap(Int32)	建立一個初始容量指定的 ArrayMap。

屬性

名稱	Description
Class	回傳此 Object的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
IsEmpty	若陣列映射中沒有項目，則回傳 true。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。 (繼承來源 JavaObject)
JniPeerMembers	ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)

方法

名稱	Description
Clear()	把陣列映射設空。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。 (繼承來源 JavaObject)
ContainsAll(ICollection<Object>)	判斷陣列映射是否包含給定集合中的所有鍵。
ContainsKey(Object)	檢查陣列中是否存在金鑰。
ContainsValue(Object)	檢查陣列中是否存在某個值。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。 (繼承來源 JavaObject)
EnsureCapacity(Int32)	確保陣列地圖至少能容納 <var>最小容量</var> 物品。
EntrySet()	回傳 a java.util.Set 以遍歷並互動陣列映射中的所有映射。
Equals(Object)	ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
ForEach(IBiConsumer)	對儲存順序中的所有元素執行指定動作。
Get(Object)	從陣列中取得一個值。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
IndexOfKey(Object)	回傳集合中某個鍵的索引。
IndexOfValue(Object)	回傳一個索引，該 #valueAt 索引會回傳指定的值;若沒有鍵對應到指定值，則回傳負數。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
KeyAt(Int32)	在陣列中指定索引處回傳金鑰。
KeySet()	回傳 a java.util.Set 以進行陣列映射中所有鍵的迭代與互動。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
Put(Object, Object)	在陣列映射中新增一個值。
PutAll(ArrayMap)	在 var array/var 中執行#put(Object, Object)所有鍵值對<的><>
PutAll(IDictionary)	在 var map/var 中執行#put(Object, Object)所有鍵值對<的><>
Remove(Object)	從陣列映射中移除一個現有的鍵。
RemoveAll(ICollection<Object>)	移除陣列映射中所有存在於該集合中的鍵。
RemoveAt(Int32)	移除給定索引上的鍵值映射。
ReplaceAll(IBiFunction)	會用呼叫該項函式的結果替換每個條目的值，直到所有條目都處理完畢或函式拋出例外為止。
RetainAll(ICollection<Object>)	移除陣列映射中所有在該集合中不存在 <b>< 或 b> 的鍵值。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。 (繼承來源 JavaObject)
SetValueAt(Int32, Object)	將值設在陣列中的指定索引。
Size()	回傳這個陣列映射中的項目數量。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
ValueAt(Int32)	回傳陣列中給定索引的值。
Values()	回傳 a java.util.Collection 以對陣列映射中的所有值進行迭代與互動。
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	ArrayMap 是一種通用的鍵>值映射資料結構，設計上比傳統 java.util.HashMap的 Deck 更節省記憶體。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。