ISharedPreferences Schnittstelle

Definition

Namespace:: Android.Content

Assembly:: Mono.Android.dll

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.

Schnittstelle für den Zugriff auf und das Ändern von Einstellungsdaten, die von Context#getSharedPreferences.

[Android.Runtime.Register("android/content/SharedPreferences", "", "Android.Content.ISharedPreferencesInvoker")]
public interface ISharedPreferences : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/content/SharedPreferences", "", "Android.Content.ISharedPreferencesInvoker")>]
type ISharedPreferences = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Attribute: RegisterAttribute

Implementiert: IJavaObject IJavaPeerable IDisposable

Hinweise

Schnittstelle für den Zugriff auf und das Ändern von Einstellungsdaten, die von Context#getSharedPreferences. Für einen bestimmten Satz von Einstellungen gibt es eine einzelne Instanz dieser Klasse, die alle Clients gemeinsam nutzen. Änderungen an den Einstellungen müssen ein Editor Objekt durchlaufen, um sicherzustellen, dass die Einstellungswerte in einem konsistenten Zustand bleiben und steuern, wenn sie für den Speicher zugesichert werden. Objekte, die von den verschiedenen get Methoden zurückgegeben werden, müssen von der Anwendung als unveränderlich behandelt werden.

SharedPreferences eignet sich am besten zum Speichern von Daten darüber, wie der Benutzer die App bevorzugt, z. B. ob der Benutzer ein bestimmtes UI-Design bevorzugt oder ob er bestimmte Inhalte in einer Liste im Vergleich zu einem Raster bevorzugt. Zu diesem Zweck spiegelt SharedPreferences Änderungen Editor#commit() committed oder Editor#apply() applied durch Editorem <>sofort</em> wider, möglicherweise bevor diese Änderungen dauerhaft beibehalten werden. Unter bestimmten Umständen, z. B. App-Abstürze oder Beenden dieser Änderungen, gehen möglicherweise verloren, auch wenn eine OnSharedPreferenceChangeListener gemeldete Änderung erfolgreich war. SharedPreferences wird nicht für das Speichern von Daten empfohlen, die für diese Art von Rollback in einem früheren Zustand wie Benutzersicherheits- oder Datenschutzeinstellungen vertraulich sind. Weitere Allgemeine Datenpersistenzoptionen finden Sie unter "Raum " oder " Datenspeicher".

<em>Note:</em> Common implementations guarantee that outstanding edits to preference files are persisted to disk when host Activities are stopped. In einigen Situationen (z. B. vor Editor#commit()Editor#apply() der Navigation außerhalb der Hostaktivität) kann dies dazu führen, dass der Hauptthread während Lebenszyklusübergangsereignissen und damit verbundenen ANR-Fehlern blockiert wird. Weitere Details finden Sie in der Dokumentation für Editor#commit() und Editor#apply().

<em>Hinweis: Diese Klasse unterstützt nicht die Verwendung über mehrere Prozesse hinweg.</em>

<div class="special reference"><h3>Developer Guides</h3>

Weitere Informationen zur Verwendung von SharedPreferences finden Sie im Entwicklerhandbuch für Datenspeicher .

</div>

Java Dokumentation für android.content.SharedPreferences.

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
All	Rufen Sie alle Werte aus den Einstellungen ab.
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)
JniPeerMembers	Mitgliedszugriff und Aufrufunterstützung. (Geerbt von IJavaPeerable)
PeerReference	Gibt eine JniObjectReference der umbrochenen Java Objektinstanz zurück. (Geerbt von IJavaPeerable)

Methoden

Name	Beschreibung
Contains(String)	Überprüft, ob die Einstellungen eine Einstellung enthalten.
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)
Edit()	Erstellen Sie einen neuen Editor für diese Einstellungen, über den Sie Änderungen an den Daten in den Einstellungen vornehmen und diese Änderungen atomar wieder auf das SharedPreferences-Objekt übernehmen können.
Finalized()	Wird aufgerufen, wenn die Instanz abgeschlossen wurde. (Geerbt von IJavaPeerable)
GetBoolean(String, Boolean)	Rufen Sie einen booleschen Wert aus den Einstellungen ab.
GetFloat(String, Single)	Rufen Sie einen Float-Wert aus den Einstellungen ab.
GetInt(String, Int32)	Rufen Sie einen Int-Wert aus den Einstellungen ab.
GetLong(String, Int64)	Rufen Sie einen langen Wert aus den Einstellungen ab.
GetString(String, String)	Rufen Sie einen String-Wert aus den Einstellungen ab.
GetStringSet(String, ICollection<String>)	Rufen Sie einen Satz von Zeichenfolgenwerten aus den Einstellungen ab.
RegisterOnSharedPreferenceChangeListener(ISharedPreferencesOnSharedPreferenceChangeListener)	Registriert einen Rückruf, der aufgerufen werden soll, wenn eine Änderung an einer Einstellung erfolgt.
SetJniIdentityHashCode(Int32)	Legen Sie den von `JniIdentityHashCode`. (Geerbt von IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Schnittstelle für den Zugriff auf und das Ändern von Einstellungsdaten, die von `Context#getSharedPreferences`. (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)
UnregisterOnSharedPreferenceChangeListener(ISharedPreferencesOnSharedPreferenceChangeListener)	Hebt die Registrierung eines vorherigen Rückrufs auf.

Erweiterungsmethoden

Name	Beschreibung
GetJniTypeName(IJavaPeerable)	Ruft den JNI-Namen des Typs der Instanz `self`ab.
JavaAs<TResult>(IJavaPeerable)	Versuchen Sie, die Eingabe `TResult`zu `self` 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)	Schnittstelle für den Zugriff auf und das Ändern von Einstellungsdaten, die von `Context#getSharedPreferences`.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Versuchen Sie, die Eingabe `TResult`zu `self` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: