Preferences.UserNodeForPackage(Class) Método

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

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

Parâmetros

Retornos

o nó de preferência do usuário associado ao pacote do qual c é membro.

Atributos

RegisterAttribute

Comentários

<aviso forte>:</forte> no Android, os nós de preferência correspondentes às preferências "sistema" e "usuário" são armazenados em seções do sistema de arquivos que estão inacessíveis aos aplicativos. Além disso, permitir que os aplicativos definam preferências "em todo o sistema" é contrário ao modelo de segurança do Android.

Retorna o nó de preferência da árvore de preferência do usuário de chamada que está associada (por convenção) ao pacote da classe especificada. A convenção é a seguinte: o nome do caminho absoluto do nó é o nome do pacote totalmente qualificado, precedido por uma barra ('/') e com cada período ('.') substituído por uma barra. Por exemplo, o nome do caminho absoluto do nó associado à classe com.acme.widget.Foo é /com/acme/widget.

Essa convenção não se aplica ao pacote sem nome, cujo nó de preferência associado é <unnamed>. Esse nó não se destina ao uso a longo prazo, mas à conveniência no desenvolvimento antecipado de programas que ainda não pertencem a um pacote e a programas "descartáveis". Dados valiosos não devem ser armazenados nesse nó, pois são compartilhados por todos os programas que os usam.

Uma classe Foo que deseja acessar preferências relativas ao seu pacote pode obter um nó de preferência da seguinte maneira:

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

Esse idioma evita a necessidade de usar uma cadeia de caracteres para descrever o nó de preferências e diminui a probabilidade de uma falha em tempo de execução. (Se o nome da classe estiver escrito incorretamente, normalmente resultará em um erro de tempo de compilação.)

Invocar esse método resultará na criação do nó retornado e seus ancestrais se eles ainda não existirem. Se o nó retornado não existir antes dessa chamada, esse nó e quaisquer ancestrais criados por essa chamada não serão garantidos para se tornarem permanentes até que o flush método seja chamado no nó retornado (ou um de seus ancestrais ou descendentes).

Java documentação para java.util.prefs.Preferences.userNodeForPackage(java.lang.Class<?>).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.