ISharedPreferences Interface

Definição

[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

Atributos

RegisterAttribute

Implementações

IJavaObject IJavaPeerable IDisposable

Comentários

Interface para acessar e modificar dados de preferência retornados por Context#getSharedPreferences. Para qualquer conjunto específico de preferências, há uma única instância dessa classe que todos os clientes compartilham. As modificações nas preferências devem passar por um Editor objeto para garantir que os valores de preferência permaneçam em um estado consistente e controle quando forem confirmados no armazenamento. Os objetos retornados dos vários get métodos devem ser tratados como imutáveis pelo aplicativo.

SharedPreferences é mais adequado para armazenar dados sobre como o usuário prefere experimentar o aplicativo, por exemplo, se o usuário prefere um tema de interface do usuário específico ou se prefere exibir conteúdo específico em uma lista versus uma grade. Para esse fim, SharedPreferences reflete as alterações Editor#commit() committed ou Editor#apply() applied por Editors <em>imediatamente</em>, potencialmente antes que essas alterações sejam persistentes de forma durável. Em algumas circunstâncias, como falhas de aplicativo ou encerramento, essas alterações podem ser perdidas, mesmo que uma OnSharedPreferenceChangeListener alteração relatada tenha sido bem-sucedida. SharedPreferences não é recomendado para armazenar dados confidenciais a esse tipo de reversão para um estado anterior, como configurações de segurança do usuário ou privacidade. Para outras opções de persistência de dados de alto nível, consulte Room ou DataStore.

<em>Observação:</em Implementações comuns garantem> que as edições pendentes nos arquivos de preferência sejam mantidas no disco quando as atividades do host forem interrompidas. Em algumas situações (por exemplo, executar muitas Editor#commit() ou Editor#apply() operações pouco antes de navegar para longe da Atividade do host), isso pode levar ao bloqueio do thread principal durante eventos de transição do ciclo de vida e erros anr associados. Para obter mais detalhes, consulte a documentação para Editor#commit() e Editor#apply().

<em>Observação: essa classe não dá suporte ao uso em vários processos.</em>

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

Para obter mais informações sobre como usar SharedPreferences, leia o guia do desenvolvedor do Armazenamento de Dados .

</div>

Java documentação para android.content.SharedPreferences.

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