Preferences.SystemNodeForPackage(Class) Méthode

[Android.Runtime.Register("systemNodeForPackage", "(Ljava/lang/Class;)Ljava/util/prefs/Preferences;", "")]
public static Java.Util.Prefs.Preferences? SystemNodeForPackage(Java.Lang.Class? c);

[<Android.Runtime.Register("systemNodeForPackage", "(Ljava/lang/Class;)Ljava/util/prefs/Preferences;", "")>]
static member SystemNodeForPackage : Java.Lang.Class -> Java.Util.Prefs.Preferences

Paramètres

Retours

nœud de préférence système associé au package dont c il s’agit d’un membre.

Attributs

RegisterAttribute

Remarques

< >strong WARNING :</strong> On Android, les nœuds De préférence correspondant aux préférences « système » et « utilisateur » sont stockés dans des sections du système de fichiers qui sont inaccessibles aux applications. En outre, permettre aux applications de définir des préférences à l’échelle du système est contraire au modèle de sécurité d’Android.

Retourne le nœud de préférence de l’arborescence de préférences système associée (par convention) au package de la classe spécifiée. La convention est la suivante : le nom absolu du chemin d’accès du nœud est le nom complet du package, précédé d’une barre oblique ('/') et de chaque point ('.') remplacé par une barre oblique. Par exemple, le nom absolu du chemin d’accès du nœud associé à la classe com.acme.widget.Foo est /com/acme/widget.

Cette convention ne s’applique pas au package sans nom, dont le nœud de préférence associé est <unnamed>. Ce nœud n’est pas destiné à une utilisation à long terme, mais pour des raisons pratiques dans le développement précoce de programmes qui n’appartiennent pas encore à un package, et pour les programmes « à distance ». Les données précieuses ne doivent pas être stockées sur ce nœud, car elles sont partagées par tous les programmes qui l’utilisent.

Une classe Foo souhaitant accéder aux préférences relatives à son package peut obtenir un nœud de préférence comme suit :

static Preferences prefs = Preferences.systemNodeForPackage(Foo.class);

Cette idiome évite la nécessité d’utiliser une chaîne pour décrire le nœud de préférences et réduit la probabilité d’une défaillance au moment de l’exécution. (Si le nom de la classe est mal orthographié, il entraîne généralement une erreur au moment de la compilation.)

L’appel de cette méthode entraîne la création du nœud retourné et de ses ancêtres s’ils n’existent pas déjà. Si le nœud retourné n’existe pas avant cet appel, ce nœud et tous les ancêtres créés par cet appel ne sont pas garantis pour devenir permanents tant que la flush méthode n’est pas appelée sur le nœud retourné (ou l’un de ses ancêtres ou descendants).

Java documentation pour java.util.prefs.Preferences.systemNodeForPackage(java.lang.Class<?>).

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.