SparseArray 類別

定義

命名空間:

Android.Util

組件:

Mono.Android.dll

SparseArray 將整數映射到物件，且與一般物件陣列不同，其索引可能包含空隙。

[Android.Runtime.Register("android/util/SparseArray", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public class SparseArray : Java.Lang.Object, IDisposable, Java.Lang.ICloneable

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

繼承

Object

JavaObject

Object

SparseArray

衍生

Android.Util.SparseArray<E>

屬性

RegisterAttribute JavaTypeParametersAttribute

實作

IJavaObject IJavaPeerable ICloneable IDisposable

備註

SparseArray 將整數映射到物件，且與一般物件陣列不同，其索引可能包含空隙。 SparseArray設計上比 c<HashMap>/c< 更省>記憶體，因為它避免了自動包箱鍵，且其資料結構不依賴每個映射額外的入口物件。

請注意，這個容器會將映射保存在陣列資料結構中，並使用二元搜尋來尋找鍵。 此實作不適用於可能包含大量項目的資料結構。 它通常比 a HashMap 慢，因為查找需要二元搜尋，加上和移除則需要在陣列中插入和刪除條目。 對於可容納數百件物品的容器，效能差異不到 50%。

為了提升效能，容器在移除鍵時包含一項優化：它不會立即壓縮陣列，而是將移除的條目標記為已刪除。 該項可重複用於同一鍵，或在所有移除條目中合併成單一垃圾回收。 當需要擴充陣列，或取得映射大小或入口值時，必須執行此垃圾回收。

可以利用 #keyAt(int) 和 #valueAt(int)來遍歷這個容器中的項目。 透過重複 keyAt(int) 使用索引的升序來遍歷這些鍵。 在 的情況下 valueAt(int)，對應鍵的值會依升序回傳。

Java 文件 android.util.SparseArray。

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

建構函式

名稱	Description
SparseArray()	建立一個新的 SparseArray，不含映射。
SparseArray(Int32)	建立一個新的 SparseArray，不含任何映射，且不需額外記憶體配置即可儲存指定數量的映射。
SparseArray(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

屬性

名稱	Description
Class	回傳此 Object的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	SparseArray 將整數映射到物件，且與一般物件陣列不同，其索引可能包含空隙。 (繼承來源 JavaObject)
JniPeerMembers	SparseArray 將整數映射到物件，且與一般物件陣列不同，其索引可能包含空隙。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
Append(Int32, Object)	將鍵值對放入陣列，優化鍵值大於陣列中所有現有鍵的情況。
Clear()	移除此 SparseArray 中的所有鍵值映射。
Clone()	建立並回傳一份此副本 Object。
Construct(JniObjectReference, JniObjectReferenceOptions)	SparseArray 將整數映射到物件，且與一般物件陣列不同，其索引可能包含空隙。 (繼承來源 JavaObject)
Contains(Int32)	如果該金鑰存在於陣列中，則回傳為真。
ContentEquals(SparseArray)	將此 SparseArray 內容與指定的 SparseArray比較。
ContentHashCode()	回傳一個雜湊碼值，將 SparseArray所有鍵與值的結果合併 Objects#hashCode(Object) 後，內容為 。
Delete(Int32)	如果有指定鍵的映射，會移除該映射。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	SparseArray 將整數映射到物件，且與一般物件陣列不同，其索引可能包含空隙。 (繼承來源 JavaObject)
Equals(Object)	SparseArray 將整數映射到物件，且與一般物件陣列不同，其索引可能包含空隙。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
Get(Int32, Object)	從指定的鍵值取得物件映射，若未映射則取得指定物件。
Get(Int32)	從指定的鍵值取得物件映射，或 null 若尚未進行此類映射。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
IndexOfKey(Int32)	回傳該索引，該索引 #keyAt 會回傳指定的鍵，若未映射指定鍵則回傳負數。
IndexOfValue(Object)	回傳一個索引，該 #valueAt 索引會回傳指定的值;若沒有鍵對應到指定值，則回傳負數。
JavaFinalize()	當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
KeyAt(Int32)	給定範圍中的 0...size()-1索引，回傳該 indexSparseArray 所儲存的第 個鍵值映射鍵。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
Put(Int32, Object)	將指定鍵的映射加到指定值，若有指定鍵，則替換先前的映射。
Remove(Int32)	#delete(int) 的別名。
RemoveAt(Int32)	移除指定索引處的映射。
RemoveAtRange(Int32, Int32)	批量移除一系列映射。
Set(Int32, Object)	別名 for #put(int, Object) 以支援 Kotlin [index]= 運算子。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	SparseArray 將整數映射到物件，且與一般物件陣列不同，其索引可能包含空隙。 (繼承來源 JavaObject)
SetValueAt(Int32, Object)	給定範圍內 0...size()-1的索引，為該 SparseArray 儲存的第 個鍵值映射設定新值 index。
Size()	回傳此 SparseArray 目前儲存的鍵值映射數量。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
ValueAt(Int32)	給定範圍中的 0...size()-1索引，回傳該 SparseArray 所儲存的第 個鍵值映射的值 index。
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	SparseArray 將整數映射到物件，且與一般物件陣列不同，其索引可能包含空隙。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	SparseArray 將整數映射到物件，且與一般物件陣列不同，其索引可能包含空隙。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	SparseArray 將整數映射到物件，且與一般物件陣列不同，其索引可能包含空隙。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	SparseArray 將整數映射到物件，且與一般物件陣列不同，其索引可能包含空隙。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	SparseArray 將整數映射到物件，且與一般物件陣列不同，其索引可能包含空隙。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	SparseArray 將整數映射到物件，且與一般物件陣列不同，其索引可能包含空隙。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。