SparseArray Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
SparseArray ordnet Ganzzahlen Objekten zu, und im Gegensatz zu einem normalen Array von Objekten können die Indizes Lücken enthalten.
[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[<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- Vererbung
- Abgeleitet
- Attribute
- Implementiert
Hinweise
SparseArray ordnet Ganzzahlen Objekten zu, und im Gegensatz zu einem normalen Array von Objekten können die Indizes Lücken enthalten. SparseArray ist für eine effizientere Speicherauslastung als ein <c>HashMap</c> vorgesehen, da es das automatische Boxen von Schlüsseln vermeidet und seine Datenstruktur nicht auf ein zusätzliches Eintragsobjekt für jede Zuordnung angewiesen ist.
Beachten Sie, dass dieser Container seine Zuordnungen in einer Arraydatenstruktur bei der Suche nach Schlüsseln beihält. Die Implementierung ist nicht für Datenstrukturen geeignet, die eine große Anzahl von Elementen enthalten können. Es ist im Allgemeinen langsamer als ein HashMap Grund, da Nachschlagevorgänge eine binäre Suche erfordern, und es werden hinzugefügt und entfernt, dass Einträge in das Array eingefügt und gelöscht werden müssen. Bei Containern mit bis zu Hunderten von Elementen beträgt der Leistungsunterschied weniger als 50 %.
Um die Leistung zu verbessern, enthält der Container beim Entfernen von Schlüsseln eine Optimierung: Anstatt das Array sofort zu komprimieren, wird der entfernte Eintrag als gelöscht markiert. Der Eintrag kann dann für denselben Schlüssel wiederverwendet oder später in einer einzigen Garbage Collection aller entfernten Einträge komprimiert werden. Diese Garbage Collection muss ausgeführt werden, wenn das Array vergrößert werden muss oder wenn die Größe oder die Eintragswerte der Zuordnung abgerufen werden.
Es ist möglich, die Elemente in diesem Container mithilfe #keyAt(int) und #valueAt(int). Beim Durchlaufen der Tasten, die mit aufsteigenden Werten des Indexes verwendet keyAt(int) werden, werden die Schlüssel in aufsteigender Reihenfolge zurückgegeben. Im Fall von valueAt(int), werden die Werte, die den Schlüsseln entsprechen, in aufsteigender Reihenfolge zurückgegeben.
Java-Dokumentation für android.util.SparseArray.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Konstruktoren
| SparseArray() |
Erstellt ein neues SparseArray ohne Zuordnungen. |
| SparseArray(Int32) |
Erstellt ein neues SparseArray ohne Zuordnungen, für die keine zusätzliche Speicherzuweisung erforderlich ist, um die angegebene Anzahl von Zuordnungen zu speichern. |
| SparseArray(IntPtr, JniHandleOwnership) |
Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen. |
Eigenschaften
| Class |
Gibt die Laufzeitklasse dieses Werts |
| Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
| JniIdentityHashCode |
|
| JniPeerMembers |
|
| PeerReference |
|
| ThresholdClass |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
| ThresholdType |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
Methoden
| Append(Int32, Object) |
Fügt ein Schlüssel-Wert-Paar in das Array ein, wobei der Fall optimiert wird, in dem der Schlüssel größer als alle vorhandenen Schlüssel im Array ist. |
| Clear() |
Entfernt alle Schlüsselwertzuordnungen aus diesem SparseArray. |
| Clone() |
Erstellt und gibt eine Kopie dieses Werts |
| Contains(Int32) |
Gibt true zurück, wenn der Schlüssel im Array vorhanden ist. |
| ContentEquals(SparseArray) |
Vergleicht den Inhalt dieses |
| ContentHashCode() |
Gibt einen Hashcodewert für den Inhalt dieser |
| Delete(Int32) |
Entfernt die Zuordnung aus dem angegebenen Schlüssel, falls vorhanden. |
| Dispose() |
|
| Dispose(Boolean) |
|
| Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object) |
| Get(Int32) |
Ruft das Objekt ab, das dem angegebenen Schlüssel zugeordnet ist, oder |
| Get(Int32, Object) |
Ruft das Objekt ab, das dem angegebenen Schlüssel zugeordnet ist, oder das angegebene Objekt, wenn keine solche Zuordnung vorgenommen wurde. |
| GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
| IndexOfKey(Int32) |
Gibt den Index zurück, |
| IndexOfValue(Object) |
Gibt einen Index zurück, |
| JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object) |
| KeyAt(Int32) |
Wenn ein Index im Bereich angegeben |
| Notify() |
Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object) |
| NotifyAll() |
Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object) |
| Put(Int32, Object) |
Fügt dem angegebenen Wert eine Zuordnung aus dem angegebenen Schlüssel hinzu, wobei die vorherige Zuordnung aus dem angegebenen Schlüssel ersetzt wird, sofern vorhanden. |
| Remove(Int32) |
Alias für |
| RemoveAt(Int32) |
Entfernt die Zuordnung am angegebenen Index. |
| RemoveAtRange(Int32, Int32) |
Entfernen Sie einen Bereich von Zuordnungen als Batch. |
| Set(Int32, Object) |
Alias zur Unterstützung von |
| SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
| SetValueAt(Int32, Object) |
Bei einem Index im Bereich |
| Size() |
Gibt die Anzahl der Schlüsselwertzuordnungen zurück, die dieses SparseArray derzeit speichert. |
| ToArray<T>() |
|
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| UnregisterFromRuntime() |
|
| ValueAt(Int32) |
Wenn ein Index im Bereich angegeben |
| Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em> oder <em>unterbrochen</em>.<>< (Geerbt von Object) |
| Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.DisposeUnlessReferenced() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniManagedPeerState |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
Erweiterungsmethoden
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
|
| GetJniTypeName(IJavaPeerable) |
|