Afficher en anglais

Partage via


SparseArray Classe

Définition

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

C#
[Android.Runtime.Register("android/util/SparseArray", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public class SparseArray : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.Lang.ICloneable
Héritage
SparseArray
Dérivé
Attributs
Implémente

Remarques

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes. SparseArrayest destiné à être plus efficace en mémoire qu’un <hashMap</c c>>, car il évite les clés de boxe automatique et sa structure de données ne repose pas sur un objet d’entrée supplémentaire pour chaque mappage.

Notez que ce conteneur conserve ses mappages dans une structure de données de tableau, à l’aide d’une recherche binaire pour rechercher des clés. L’implémentation n’est pas destinée à être appropriée pour les structures de données qui peuvent contenir un grand nombre d’éléments. Il est généralement plus lent qu’un HashMap car les recherches nécessitent une recherche binaire, et ajoute et supprime nécessitent l’insertion et la suppression d’entrées dans le tableau. Pour les conteneurs contenant jusqu’à des centaines d’éléments, la différence de performances est inférieure à 50 %.

Pour faciliter les performances, le conteneur inclut une optimisation lors de la suppression de clés : au lieu de compacter immédiatement son tableau, il laisse l’entrée supprimée marquée comme supprimée. L’entrée peut ensuite être réutilisée pour la même clé ou compactée ultérieurement dans un seul garbage collection de toutes les entrées supprimées. Ce garbage collection doit être effectué chaque fois que le tableau doit être agrandi, ou lorsque la taille de la carte ou les valeurs d’entrée sont récupérées.

Il est possible d’itérer sur les éléments de ce conteneur à l’aide #keyAt(int) et #valueAt(int). L’itération sur les clés à l’aide keyAt(int) de valeurs croissants de l’index retourne les clés dans l’ordre croissant. Dans le cas de valueAt(int), les valeurs correspondant aux clés sont retournées dans l’ordre croissant.

Documentation Java pour android.util.SparseArray.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

Constructeurs

SparseArray()

Crée un nouveau SparseArray contenant aucun mappage.

SparseArray(Int32)

Crée un nouveau SparseArray contenant aucun mappage qui ne nécessite aucune allocation de mémoire supplémentaire pour stocker le nombre spécifié de mappages.

SparseArray(IntPtr, JniHandleOwnership)

Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime.

Propriétés

Class

Retourne la classe runtime de ce Object.

(Hérité de Object)
Handle

Handle de l’instance Android sous-jacente.

(Hérité de Object)
JniIdentityHashCode

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

(Hérité de Object)
JniPeerMembers

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

PeerReference

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

(Hérité de Object)
ThresholdClass

Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.

ThresholdType

Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.

Méthodes

Append(Int32, Object)

Place une paire clé/valeur dans le tableau, en optimisant le cas où la clé est supérieure à toutes les clés existantes du tableau.

Clear()

Supprime tous les mappages clé-valeur de ce SparseArray.

Clone()

Crée et retourne une copie de ce Objectfichier .

Contains(Int32)

Retourne true si la clé existe dans le tableau.

ContentEquals(SparseArray)

Compare le contenu de ce SparseArray contenu au contenu spécifié SparseArray.

ContentHashCode()

Retourne une valeur de code de hachage pour le contenu de ce SparseArraycode, combinant le Objects#hashCode(Object) résultat de toutes ses clés et valeurs.

Delete(Int32)

Supprime le mappage de la clé spécifiée, le cas échéant.

Dispose()

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

(Hérité de Object)
Dispose(Boolean)

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

(Hérité de Object)
Equals(Object)

Indique si un autre objet est « égal à » celui-ci.

(Hérité de Object)
Get(Int32)

Obtient l’objet mappé à partir de la clé spécifiée, ou null si aucun tel mappage n’a été effectué.

Get(Int32, Object)

Obtient l’objet mappé à partir de la clé spécifiée ou l’objet spécifié si aucun mappage de ce type n’a été effectué.

GetHashCode()

Retourne une valeur de code de hachage pour l'objet.

(Hérité de Object)
IndexOfKey(Int32)

Retourne l’index pour lequel #keyAt retourne la clé spécifiée, ou un nombre négatif si la clé spécifiée n’est pas mappée.

IndexOfValue(Object)

Retourne un index pour lequel #valueAt retourne la valeur spécifiée, ou un nombre négatif si aucune clé n’est mappée à la valeur spécifiée.

JavaFinalize()

Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet.

(Hérité de Object)
KeyAt(Int32)

Étant donné un index dans la plage 0...size()-1, retourne la clé à partir du indexmappage clé-valeur que ce SparseArray stocke.

Notify()

Réveille un thread unique qui attend le moniteur de cet objet.

(Hérité de Object)
NotifyAll()

Réveille tous les threads qui attendent le moniteur de cet objet.

(Hérité de Object)
Put(Int32, Object)

Ajoute un mappage de la clé spécifiée à la valeur spécifiée, en remplaçant le mappage précédent de la clé spécifiée s’il en existe un.

Remove(Int32)

Alias de #delete(int).

RemoveAt(Int32)

Supprime le mappage à l’index spécifié.

RemoveAtRange(Int32, Int32)

Supprimez une plage de mappages en tant que lot.

Set(Int32, Object)

Alias pour #put(int, Object) prendre en charge l’opérateur Kotlin [index]=.

SetHandle(IntPtr, JniHandleOwnership)

Définit la propriété Handle.

(Hérité de Object)
SetValueAt(Int32, Object)

Étant donné un index dans la plage 0...size()-1, définit une nouvelle valeur pour le indexmappage clé-valeur que ce SparseArray stocke.

Size()

Retourne le nombre de mappages clé-valeur que ce SparseArray stocke actuellement.

ToArray<T>()

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

(Hérité de Object)
ToString()

Retourne une représentation de chaîne de l'objet.

(Hérité de Object)
UnregisterFromRuntime()

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

(Hérité de Object)
ValueAt(Int32)

Étant donné un index dans la plage 0...size()-1, retourne la valeur du indexmappage clé-valeur que ce SparseArray stocke.

Wait()

Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<>

(Hérité de Object)
Wait(Int64)

Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée.

(Hérité de Object)
Wait(Int64, Int32)

Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée.

(Hérité de Object)

Implémentations d’interfaces explicites

IJavaPeerable.Disposed()

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

(Hérité de Object)
IJavaPeerable.DisposeUnlessReferenced()

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

(Hérité de Object)
IJavaPeerable.Finalized()

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

(Hérité de Object)
IJavaPeerable.JniManagedPeerState

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

(Hérité de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

(Hérité de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

(Hérité de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

(Hérité de Object)

Méthodes d’extension

JavaCast<TResult>(IJavaObject)

Effectue une conversion de type vérifiée par le runtime Android.

JavaCast<TResult>(IJavaObject)

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

GetJniTypeName(IJavaPeerable)

SparseArray mappe des entiers aux objets et, contrairement à un tableau normal d’objets, ses index peuvent contenir des lacunes.

S’applique à

Produit Versions
.NET for Android .NET for Android API 33, .NET for Android API 34