Sprache

IPreferenceDataStore Schnittstelle

Definition

Eine Schnittstelle zum Datenspeicher, die implementiert und dem Einstellungsframework bereitgestellt werden soll.

[Android.Runtime.Register("android/preference/PreferenceDataStore", "", "Android.Preferences.IPreferenceDataStoreInvoker", ApiSince=26)]
public interface IPreferenceDataStore : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("android/preference/PreferenceDataStore", "", "Android.Preferences.IPreferenceDataStoreInvoker", ApiSince=26)>]
type IPreferenceDataStore = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
Attribute
Implementiert

Hinweise

Eine Schnittstelle zum Datenspeicher, die implementiert und dem Einstellungsframework bereitgestellt werden soll. Dies kann verwendet werden, um die Standardeinstellung android.content.SharedPreferencesbei Bedarf zu ersetzen.

In den meisten Fällen möchten Sie sie verwenden android.content.SharedPreferences , da sie automatisch gesichert und auf neue Geräte migriert wird. Die Bereitstellung eines benutzerdefinierten Datenspeichers für Einstellungen kann jedoch hilfreich sein, wenn Ihre App ihre Einstellungen in einer lokalen Db, Cloud oder gerätespezifisch wie "Entwicklereinstellungen" speichert. Es kann auch hilfreich sein, wenn Sie die Einstellungs-UI verwenden möchten, aber die Daten sollten nicht überhaupt gespeichert werden, da sie nur pro Sitzung gültig sind.

Sobald eine Put-Methode aufgerufen wird, ist sie voll verantwortlich für die Implementierung des Datenspeichers, um die angegebenen Werte sicher zu speichern. Zeitintensive Vorgänge müssen im Hintergrund ausgeführt werden, um zu verhindern, dass die Benutzeroberfläche blockiert wird. Außerdem müssen Sie einen Plan zum Serialisieren der Daten haben, falls die Aktivität, in der dieses Objekt gehalten wird, zerstört wird.

Standardmäßig werden alle "put"-Methoden ausgelöst UnsupportedOperationException.

Dieses Element ist veraltet. Verwenden Sie die AndroidX-Einstellungsbibliothek für ein einheitliches Verhalten auf allen Geräten. Weitere Informationen zur Verwendung der AndroidX-Einstellungsbibliothek finden Sie unter "Einstellungen".

Java Dokumentation für android.preference.PreferenceDataStore.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Eigenschaften

Name Beschreibung
Handle

Ruft den JNI-Wert des zugrunde liegenden Android-Objekts ab.

(Geerbt von IJavaObject)
JniIdentityHashCode

Gibt den Wert java.lang.System.identityHashCode() für die umbrochene Instanz zurück.

(Geerbt von IJavaPeerable)
JniManagedPeerState

Status des verwalteten Peers.

(Geerbt von IJavaPeerable)
JniObjectReferenceControlBlock

Eine Schnittstelle zum Datenspeicher, die implementiert und dem Einstellungsframework bereitgestellt werden soll.

(Geerbt von IJavaPeerable)
JniPeerMembers

Mitgliedszugriff und Aufrufunterstützung.

(Geerbt von IJavaPeerable)
PeerReference

Gibt eine JniObjectReference der umbrochenen Java Objektinstanz zurück.

(Geerbt von IJavaPeerable)

Methoden

Name Beschreibung
Disposed()

Wird aufgerufen, wenn die Instanz verworfen wurde.

(Geerbt von IJavaPeerable)
DisposeUnlessReferenced()

Wenn keine offenen Verweise auf diese Instanz vorhanden sind, wird nichts aufgerufen Dispose(). Andernfalls wird nichts ausgeführt.

(Geerbt von IJavaPeerable)
Finalized()

Wird aufgerufen, wenn die Instanz abgeschlossen wurde.

(Geerbt von IJavaPeerable)
GetBoolean(String, Boolean)

Rufen Sie einen booleschen Wert aus dem Datenspeicher ab.

GetFloat(String, Single)

Rufen Sie einen Float-Wert aus dem Datenspeicher ab.

GetInt(String, Int32)

Rufen Sie einen Int-Wert aus dem Datenspeicher ab.

GetLong(String, Int64)

Rufen Sie einen langen Wert aus dem Datenspeicher ab.

GetString(String, String)

Rufen Sie einen String-Wert aus dem Datenspeicher ab.

GetStringSet(String, ICollection<String>)

Rufen Sie einen Satz von Zeichenfolgenwerten aus dem Datenspeicher ab.

PutBoolean(String, Boolean)

Legen Sie einen booleschen Wert auf den Datenspeicher fest.

PutFloat(String, Single)

Legen Sie einen Float-Wert auf den Datenspeicher fest.

PutInt(String, Int32)

Legen Sie einen Int-Wert auf den Datenspeicher fest.

PutLong(String, Int64)

Legen Sie einen langen Wert auf den Datenspeicher fest.

PutString(String, String)

Legen Sie einen String-Wert auf den Datenspeicher fest.

PutStringSet(String, ICollection<String>)

Legen Sie einen Satz von Zeichenfolgenwert auf den Datenspeicher fest.

SetJniIdentityHashCode(Int32)

Legen Sie den von JniIdentityHashCode.

(Geerbt von IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)

Eine Schnittstelle zum Datenspeicher, die implementiert und dem Einstellungsframework bereitgestellt werden soll.

(Geerbt von IJavaPeerable)
SetPeerReference(JniObjectReference)

Legen Sie den von PeerReference.

(Geerbt von IJavaPeerable)
UnregisterFromRuntime()

Heben Sie die Registrierung dieser Instanz auf, damit die Laufzeit sie nicht aus zukünftigen Java.Interop.JniRuntime+JniValueManager.PeekValue Aufrufen zurückgibt.

(Geerbt von IJavaPeerable)

Erweiterungsmethoden

Name Beschreibung
GetJniTypeName(IJavaPeerable)

Ruft den JNI-Namen des Typs der Instanz selfab.

JavaAs<TResult>(IJavaPeerable)

Versuchen Sie, die Eingabe selfzu TResult erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

JavaCast<TResult>(IJavaObject)

Führt eine android-laufzeitgecheckte Typkonvertierung aus.

JavaCast<TResult>(IJavaObject)

Eine Schnittstelle zum Datenspeicher, die implementiert und dem Einstellungsframework bereitgestellt werden soll.

TryJavaCast<TResult>(IJavaPeerable, TResult)

Versuchen Sie, die Eingabe selfzu TResult erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: