Armazenar e recuperar configurações e outros dados do aplicativo

Dados da aplicação são dados mutáveis criados e geridos por uma aplicação específica. Ele inclui o estado de tempo de execução, configurações do aplicativo, preferências do usuário, conteúdo de referência (como as definições de dicionário em um aplicativo de dicionário) e outras configurações. Os dados do aplicativo são diferentes dos dados do usuário, dados que o usuário cria e gerencia ao usar um aplicativo. Os dados do usuário incluem arquivos de documentos ou mídia, transcrições de e-mail ou comunicação ou registros de banco de dados contendo conteúdo criado pelo usuário. Os dados do usuário podem ser úteis ou significativos para mais de um aplicativo. Muitas vezes, são dados que o usuário deseja manipular ou transmitir como uma entidade independente do próprio aplicativo, como um documento.

Observação importante sobre os dados do aplicativo: O tempo de vida dos dados do aplicativo está vinculado ao tempo de vida do aplicativo. Se o aplicativo for removido, todos os dados do aplicativo serão perdidos como consequência. Não use dados de aplicativos para armazenar dados do usuário ou qualquer coisa que os usuários possam perceber como valiosa e insubstituível. Recomendamos que as bibliotecas do usuário e o Microsoft OneDrive sejam usados para armazenar esse tipo de informação. Os dados do aplicativo são ideais para armazenar preferências, configurações e favoritos do usuário específicos do aplicativo.

Tipos de dados do aplicativo

Existem dois tipos de dados da aplicação: definições e ficheiros.

Configurações

Use as configurações para armazenar as preferências do usuário e as informações de estado do aplicativo. A API de dados do aplicativo permite que você crie e recupere configurações facilmente (mostraremos alguns exemplos mais adiante neste artigo).

Aqui estão os tipos de dados que você pode usar para as configurações do aplicativo:

• UInt8 , Int16, UInt16, Int32, UInt32, Int64, UInt64, Simples, Duplo
• Booleano
• Char16, Corda
• DateTimeTimeSpan
  • Para C#/.NET, use: System.DateTimeOffset, System.TimeSpan
• GUID, Ponto, Tamanho, Retângulo
• ApplicationDataCompositeValue: um conjunto de configurações de aplicativo relacionadas que devem ser serializadas e desserializadas atomicamente. Use configurações compostas para lidar facilmente com atualizações atômicas de configurações interdependentes. O sistema garante a integridade das configurações compostas durante o acesso simultâneo e o roaming. As configurações compostas são otimizadas para pequenas quantidades de dados, e o desempenho pode ser ruim se você usá-las para grandes conjuntos de dados.

Ficheiros

Use arquivos para armazenar dados binários ou para habilitar seus próprios tipos serializados personalizados.

Armazenando dados de aplicativos nos repositórios de dados de aplicativos

Quando um aplicativo é instalado, o sistema fornece seus próprios armazenamentos de dados por usuário para configurações e arquivos. Você não precisa saber onde ou como esses dados existem, porque o sistema é responsável por gerenciar o armazenamento físico, garantindo que os dados sejam mantidos isolados de outros aplicativos e outros usuários. O sistema também preserva o conteúdo desses armazenamentos de dados quando o usuário instala uma atualização para seu aplicativo e remove o conteúdo desses armazenamentos de dados de forma completa e limpa quando seu aplicativo é desinstalado.

Dentro de seu repositório de dados de aplicativos, cada aplicativo tem diretórios raiz definidos pelo sistema: um para arquivos locais, um para arquivos móveis e um para arquivos temporários. Seu aplicativo pode adicionar novos arquivos e novos contêineres a cada um desses diretórios raiz.

Dados do aplicativo local

Os dados do aplicativo local devem ser usados para qualquer informação que precise ser preservada entre as sessões do aplicativo e não seja adequada para dados do aplicativo em roaming. Os dados que não são aplicáveis em outros dispositivos também devem ser armazenados aqui. Não há nenhuma restrição geral de tamanho nos dados locais armazenados. Use o repositório de dados de aplicativos local para dados que não fazem sentido usar roaming e para grandes conjuntos de dados.

Recuperar o repositório de dados de aplicativos local

Antes de ler ou gravar dados de aplicativos locais, você deve recuperar o repositório de dados de aplicativos local. Para recuperar o repositório de dados do aplicativo local, use a propriedade ApplicationData.LocalSettings para obter as configurações locais do aplicativo como um objeto ApplicationDataContainer . Utilize a propriedade ApplicationData.LocalFolder para obter ficheiros num objeto StorageFolder. Use a propriedade ApplicationData.LocalCacheFolder para obter a pasta no repositório de dados do aplicativo local onde você pode salvar arquivos que não estão incluídos no backup e na restauração.

Windows.Storage.ApplicationDataContainer localSettings = 
    Windows.Storage.ApplicationData.Current.LocalSettings;
Windows.Storage.StorageFolder localFolder = 
    Windows.Storage.ApplicationData.Current.LocalFolder;

Criar e recuperar uma configuração local simples

Para criar ou escrever uma configuração, use a propriedade ApplicationDataContainer.Values para acessar as configurações no localSettings contêiner que obtivemos na etapa anterior. Este exemplo cria uma configuração chamada exampleSetting.

// Simple setting

localSettings.Values["exampleSetting"] = "Hello Windows";

Para recuperar a configuração, use a mesma propriedade ApplicationDataContainer.Values que usou para criar a configuração. Este exemplo mostra como recuperar a configuração que acabamos de criar.

// Simple setting
Object value = localSettings.Values["exampleSetting"];

Criar e recuperar um valor composto local

Para criar ou escrever um valor composto, crie um objeto ApplicationDataCompositeValue . Este exemplo cria uma configuração composta chamada exampleCompositeSetting e a adiciona ao localSettings contêiner.

// Composite setting

Windows.Storage.ApplicationDataCompositeValue composite = 
    new Windows.Storage.ApplicationDataCompositeValue();
composite["intVal"] = 1;
composite["strVal"] = "string";

localSettings.Values["exampleCompositeSetting"] = composite;

Este exemplo mostra como recuperar o valor composto que acabamos de criar.

// Composite setting

Windows.Storage.ApplicationDataCompositeValue composite = 
   (Windows.Storage.ApplicationDataCompositeValue)localSettings.Values["exampleCompositeSetting"];

if (composite == null)
{
   // No data
}
else
{
   // Access data in composite["intVal"] and composite["strVal"]
}

Criar e ler um arquivo local

Para criar e atualizar um arquivo no repositório de dados do aplicativo local, use as APIs de arquivo, como Windows.Storage.StorageFolder.CreateFileAsync e Windows.Storage.FileIO.WriteTextAsync. Este exemplo cria um ficheiro nomeado dataFile.txt no contentor localFolder e grava a data e hora atuais no ficheiro. O valor ReplaceExisting da enumeração CreationCollisionOption indica que se deve substituir o ficheiro se ele já existir.

async void WriteTimestamp()
{
   Windows.Globalization.DateTimeFormatting.DateTimeFormatter formatter = 
       new Windows.Globalization.DateTimeFormatting.DateTimeFormatter("longtime");

   StorageFile sampleFile = await localFolder.CreateFileAsync("dataFile.txt", 
       CreationCollisionOption.ReplaceExisting);
   await FileIO.WriteTextAsync(sampleFile, formatter.Format(DateTimeOffset.Now));
}

Para abrir e ler um arquivo no repositório de dados de aplicativo local, use as APIs de arquivo, como Windows.Storage.StorageFolder.GetFileAsync, Windows.Storage.StorageFile.GetFileFromApplicationUriAsync e Windows.Storage.FileIO.ReadTextAsync. Este exemplo abre o dataFile.txt arquivo criado na etapa anterior e lê a data do arquivo. Para obter detalhes sobre como carregar recursos de arquivo de vários locais, consulte Como carregar recursos de arquivo.

async void ReadTimestamp()
{
   try
   {
      StorageFile sampleFile = await localFolder.GetFileAsync("dataFile.txt");
      String timestamp = await FileIO.ReadTextAsync(sampleFile);
      // Data is contained in timestamp
   }
   catch (Exception)
   {
      // Timestamp not found
   }
}

Dados de roaming

Se você usa dados de roaming em seu aplicativo, seus usuários podem facilmente manter os dados do aplicativo sincronizados em vários dispositivos. Se um usuário instalar seu aplicativo em vários dispositivos, o sistema operacional manterá os dados do aplicativo sincronizados, reduzindo a quantidade de trabalho de configuração que o usuário precisa fazer para seu aplicativo em seu segundo dispositivo. O roaming também permite que os usuários continuem uma tarefa, como compor uma lista, exatamente de onde pararam, mesmo em um dispositivo diferente. O SO replica dados em roaming para a nuvem quando é atualizado e sincroniza os dados com os outros dispositivos nos quais a aplicação está instalada.

O SO limita o tamanho dos dados da aplicação que cada aplicação pode utilizar em roaming. Consulte ApplicationData.RoamingStorageQuota. Se o aplicativo atingir esse limite, nenhum dos dados do aplicativo será replicado para a nuvem até que o total de dados do aplicativo em roaming seja inferior ao limite novamente. Por esse motivo, é uma prática recomendada usar dados de roaming apenas para preferências do usuário, links e pequenos arquivos de dados.

Os dados de roaming de uma aplicação estão disponíveis na nuvem, desde que sejam acedidos pelo utilizador a partir de algum dispositivo dentro do intervalo de tempo necessário. Se o usuário não executar um aplicativo por mais tempo do que esse intervalo de tempo, seus dados de roaming serão removidos da nuvem. Se um usuário desinstalar um aplicativo, seus dados de roaming não serão removidos automaticamente da nuvem, mas serão preservados. Se o usuário reinstalar o aplicativo dentro do intervalo de tempo, os dados de roaming serão sincronizados a partir da nuvem.

Recomendações e precauções para dados em roaming

Consulte a observação importante sobre dados de roaming.

• Use o roaming para preferências e personalizações do usuário, links e pequenos arquivos de dados. Por exemplo, use o roaming para preservar a preferência de cor de plano de fundo de um usuário em todos os dispositivos.
• Use o roaming para permitir que os usuários continuem uma tarefa entre dispositivos. Por exemplo, dados de aplicativos em roaming, como o conteúdo de um e-mail guardado como rascunho ou a página mais recentemente visualizada em um aplicativo leitor.
• Manipule o evento DataChanged atualizando os dados do aplicativo. Esse evento ocorre quando os dados do aplicativo acabam de terminar a sincronização da nuvem.
• Deslocar referências a conteúdo em vez de dados brutos. Por exemplo, explore o endereço de um URL em vez do conteúdo de um artigo online.
• Para configurações importantes e críticas de tempo, use a configuração HighPriority associada a RoamingSettings.
• Não faça roaming de dados de aplicativos específicos de um dispositivo. Algumas informações são pertinentes apenas localmente, como um nome de caminho para um recurso de arquivo local. Se decidir navegar por informações locais, certifique-se de que a aplicação pode recuperar-se se as informações não forem válidas no dispositivo secundário.
• Não faça roaming de grandes conjuntos de dados de aplicativos. Há um limite para a quantidade de dados de aplicativo que um aplicativo pode a roamear; use a propriedade RoamingStorageQuota para obter esse máximo. Se uma aplicação atingir esse limite, nenhum dado poderá fazer roaming até que o tamanho do repositório de dados da aplicação deixe de exceder o limite. Ao projetar seu aplicativo, considere como colocar um limite em dados maiores para não exceder o limite. Por exemplo, se salvar um estado de jogo requer 10KB cada, o aplicativo pode permitir que o usuário armazene até 10 jogos.
• Não use roaming para dados que dependem de sincronização instantânea. O Windows não garante uma sincronização instantânea; O roaming pode ser significativamente atrasado se um usuário estiver offline ou em uma rede de alta latência. Certifique-se de que sua interface do usuário não dependa da sincronização instantânea.
• Não use roaming para dados que mudam frequentemente. Por exemplo, se o seu aplicativo rastrear informações que mudam com frequência, como a posição de uma música por segundo, não armazene isso como dados de aplicativo em roaming. Em vez disso, escolha uma representação menos frequente que ainda forneça uma boa experiência ao usuário, como a música que está sendo executada no momento.

Pré-requisitos de roaming

Consulte a observação importante sobre dados de roaming.

Qualquer utilizador pode beneficiar dos dados de aplicação em roaming se utilizar uma conta Microsoft para iniciar sessão no seu dispositivo. No entanto, os usuários e administradores de política de grupo podem desativar os dados de aplicativos em roaming em um dispositivo a qualquer momento. Se um usuário optar por não usar uma conta da Microsoft ou desativar os recursos de dados em roaming, ele ainda poderá usar seu aplicativo, mas os dados do aplicativo serão locais para cada dispositivo.

Os dados armazenados no PasswordVault só farão a transição se um usuário tiver tornado um dispositivo "confiável". Se um dispositivo não for confiável, os dados protegidos neste cofre não serão móveis.

Resolução de conflitos

Consulte a observação importante sobre dados de roaming.

Os dados da aplicação em roaming não se destinam a ser utilizados em simultâneo em mais do que um dispositivo de cada vez. Se surgir um conflito durante a sincronização porque uma determinada unidade de dados foi alterada em dois dispositivos, o sistema sempre favorecerá o valor que foi escrito por último. Isso garante que o aplicativo utilize as informações mais up-todatadas. Se a unidade de dados for um composto de configuração, a resolução de conflitos ainda ocorrerá no nível da unidade de configuração, o que significa que o composto com a última alteração será sincronizado.

Quando gravar dados

Consulte a observação importante sobre dados de roaming.

Dependendo do tempo de vida esperado da configuração, os dados devem ser gravados em momentos diferentes. Os dados do aplicativo que mudam com pouca frequência ou lentamente devem ser gravados imediatamente. No entanto, os dados do aplicativo que mudam com frequência só devem ser gravados periodicamente em intervalos regulares (como uma vez a cada 5 minutos), bem como quando o aplicativo é suspenso. Por exemplo, uma aplicação de música pode guardar as definições de "música atual" sempre que uma nova música começar a ser reproduzida; no entanto, a posição real na música deve ser guardada apenas quando suspensa.

Proteção de uso excessivo

Consulte a observação importante sobre dados de roaming.

O sistema dispõe de vários mecanismos de proteção para evitar uma utilização inadequada dos recursos. Se os dados do aplicativo não fizerem a transição conforme o esperado, é provável que o dispositivo tenha sido temporariamente restringido. Esperar por algum tempo geralmente resolverá essa situação automaticamente e nenhuma ação é necessária.

Gestão de Versões

Consulte a observação importante sobre dados de roaming.

Os dados do aplicativo podem utilizar o controle de versão para atualizar de uma estrutura de dados para outra. O número da versão é diferente da versão do aplicativo e pode ser definido à vontade. Embora não seja imposto, é altamente recomendável que você use números de versão crescentes, pois complicações indesejáveis (incluindo perda de dados) podem ocorrer se você tentar fazer a transição para um número de versão de dados mais baixo que represente dados mais recentes.

Os dados da aplicação apenas circulam entre aplicações instaladas com o mesmo número de versão. Por exemplo, os dispositivos na versão 2 farão a transição de dados entre si e os dispositivos na versão 3 farão o mesmo, mas não ocorrerá roaming entre um dispositivo que executa a versão 2 e um dispositivo que executa a versão 3. Se você instalar um novo aplicativo que utilizou vários números de versão em outros dispositivos, o aplicativo recém-instalado sincronizará os dados do aplicativo associados ao número de versão mais alto.

Testes e ferramentas

Consulte a observação importante sobre dados de roaming.

Os desenvolvedores podem bloquear seus dispositivos para acionar uma sincronização de dados de aplicativos em roaming. Se parecer que os dados do aplicativo não transitam dentro de um determinado período de tempo, verifique os seguintes itens e certifique-se de que:

• Seus dados de roaming não excedem o tamanho máximo (consulte RoamingStorageQuota para obter detalhes).
• Os seus ficheiros são fechados e libertados corretamente.
• Há pelo menos dois dispositivos executando a mesma versão do aplicativo.

Registe-se para receber notificações quando houver alterações nos dados de roaming.

Consulte a observação importante sobre dados de roaming.

Para usar dados de aplicativos de roaming, você precisa se registrar para alterações de dados de roaming e recuperar os contêineres de dados de roaming para poder ler e gravar configurações.

1. Registe-se para receber notificações quando os dados em roaming forem alterados.

   O evento DataChanged notifica-o quando os dados de roaming são alterados. Este exemplo define DataChangeHandler como o manipulador para alterações de dados em roaming.

void InitHandlers()
    {
       Windows.Storage.ApplicationData.Current.DataChanged += 
          new TypedEventHandler<ApplicationData, object>(DataChangeHandler);
    }

    void DataChangeHandler(Windows.Storage.ApplicationData appData, object o)
    {
       // TODO: Refresh your data
    }

2. Obtenha os contêineres para as configurações e arquivos do aplicativo.

   Use a propriedade ApplicationData.RoamingSettings para obter as configurações e a propriedade ApplicationData.RoamingFolder para obter os arquivos.

Windows.Storage.ApplicationDataContainer roamingSettings = 
        Windows.Storage.ApplicationData.Current.RoamingSettings;
    Windows.Storage.StorageFolder roamingFolder = 
        Windows.Storage.ApplicationData.Current.RoamingFolder;

Criar e recuperar configurações de roaming

Consulte a observação importante sobre dados de roaming.

Use a propriedade ApplicationDataContainer.Values para acessar as configurações no roamingSettings contêiner que obtivemos na seção anterior. Este exemplo cria uma configuração simples chamada exampleSetting e um valor composto chamado composite.

// Simple setting

roamingSettings.Values["exampleSetting"] = "Hello World";
// High Priority setting, for example, last page position in book reader app
roamingSettings.values["HighPriority"] = "65";

// Composite setting

Windows.Storage.ApplicationDataCompositeValue composite = 
    new Windows.Storage.ApplicationDataCompositeValue();
composite["intVal"] = 1;
composite["strVal"] = "string";

roamingSettings.Values["exampleCompositeSetting"] = composite;

Este exemplo recupera as configurações que acabamos de criar.

// Simple setting

Object value = roamingSettings.Values["exampleSetting"];

// Composite setting

Windows.Storage.ApplicationDataCompositeValue composite = 
   (Windows.Storage.ApplicationDataCompositeValue)roamingSettings.Values["exampleCompositeSetting"];

if (composite == null)
{
   // No data
}
else
{
   // Access data in composite["intVal"] and composite["strVal"]
}

Criar e recuperar arquivos de roaming

Consulte a observação importante sobre dados de roaming.

Para criar e atualizar um arquivo no repositório de dados de aplicativos móveis, use as APIs de arquivo, como Windows.Storage.StorageFolder.CreateFileAsync e Windows.Storage.FileIO.WriteTextAsync. Este exemplo cria um ficheiro nomeado dataFile.txt no contentor roamingFolder e grava a data e hora atuais no ficheiro. O valor ReplaceExisting da enumeração CreationCollisionOption indica que se deve substituir o ficheiro se ele já existir.

async void WriteTimestamp()
{
   Windows.Globalization.DateTimeFormatting.DateTimeFormatter formatter = 
       new Windows.Globalization.DateTimeFormatting.DateTimeFormatter("longtime");

   StorageFile sampleFile = await roamingFolder.CreateFileAsync("dataFile.txt", 
       CreationCollisionOption.ReplaceExisting);
   await FileIO.WriteTextAsync(sampleFile, formatter.Format(DateTimeOffset.Now));
}

Para abrir e ler um arquivo no repositório de dados de aplicativos móveis, use as APIs de arquivo, como Windows.Storage.StorageFolder.GetFileAsync, Windows.Storage.StorageFile.GetFileFromApplicationUriAsync e Windows.Storage.FileIO.ReadTextAsync. Este exemplo abre o dataFile.txt arquivo criado na seção anterior e lê a data do arquivo. Para obter detalhes sobre como carregar recursos de arquivo de vários locais, consulte Como carregar recursos de arquivo.

async void ReadTimestamp()
{
   try
   {
      StorageFile sampleFile = await roamingFolder.GetFileAsync("dataFile.txt");
      String timestamp = await FileIO.ReadTextAsync(sampleFile);
      // Data is contained in timestamp
   }
   catch (Exception)
   {
      // Timestamp not found
   }
}

Dados temporários do aplicativo

O armazenamento temporário de dados de aplicativos funciona como um cache. Seus arquivos não roam e podem ser removidos a qualquer momento. A tarefa de Manutenção do Sistema pode excluir automaticamente os dados armazenados neste local a qualquer momento. O usuário também pode limpar arquivos do armazenamento de dados temporário usando a Limpeza de Disco. Os dados temporários do aplicativo podem ser usados para armazenar informações temporárias durante uma sessão do aplicativo. Não há garantia de que esses dados persistirão além do final da sessão do aplicativo, pois o sistema pode recuperar o espaço usado, se necessário. A localização está disponível através da propriedade temporaryFolder.

Recuperar o contêiner de dados temporário

Use a propriedade ApplicationData.TemporaryFolder para obter os arquivos. As próximas etapas usam a temporaryFolder variável desta etapa.

Windows.Storage.StorageFolder temporaryFolder = ApplicationData.Current.TemporaryFolder;

Criar e ler arquivos temporários

Para criar e atualizar um arquivo no repositório de dados temporário do aplicativo, use as APIs de arquivo, como Windows.Storage.StorageFolder.CreateFileAsync e Windows.Storage.FileIO.WriteTextAsync. Este exemplo cria um ficheiro nomeado dataFile.txt no contentor temporaryFolder e grava a data e hora atuais no ficheiro. O valor ReplaceExisting da enumeração CreationCollisionOption indica que se deve substituir o ficheiro se ele já existir.

async void WriteTimestamp()
{
   Windows.Globalization.DateTimeFormatting.DateTimeFormatter formatter = 
       new Windows.Globalization.DateTimeFormatting.DateTimeFormatter("longtime");

   StorageFile sampleFile = await temporaryFolder.CreateFileAsync("dataFile.txt", 
       CreateCollisionOption.ReplaceExisting);
   await FileIO.WriteTextAsync(sampleFile, formatter.Format(DateTimeOffset.Now));
}

Para abrir e ler um arquivo no repositório de dados temporário do aplicativo, use as APIs de arquivo, como Windows.Storage.StorageFolder.GetFileAsync, Windows.Storage.StorageFile.GetFileFromApplicationUriAsync e Windows.Storage.FileIO.ReadTextAsync. Este exemplo abre o dataFile.txt arquivo criado na etapa anterior e lê a data do arquivo. Para obter detalhes sobre como carregar recursos de arquivo de vários locais, consulte Como carregar recursos de arquivo.

async void ReadTimestamp()
{
   try
   {
      StorageFile sampleFile = await temporaryFolder.GetFileAsync("dataFile.txt");
      String timestamp = await FileIO.ReadTextAsync(sampleFile);
      // Data is contained in timestamp
   }
   catch (Exception)
   {
      // Timestamp not found
   }
}

Organizar dados de aplicativos com contêineres

Para o ajudar a organizar as definições de dados e ficheiros da aplicação, deve criar contêineres (representados por objetos ApplicationDataContainer), em vez de trabalhar diretamente com diretórios. Você pode adicionar contêineres aos armazenamentos de dados de aplicativos locais, móveis e temporários. Os contêineres podem ser aninhados em até 32 níveis de profundidade.

Para criar um contentor de definições, chame o método ApplicationDataContainer.CreateContainer. Este exemplo cria um contêiner de configurações locais chamado exampleContainer e adiciona uma configuração chamada exampleSetting. O valor Always da enumeração ApplicationDataCreateDisposition indica que o contentor é criado caso ainda não exista.

Windows.Storage.ApplicationDataContainer localSettings = 
    Windows.Storage.ApplicationData.Current.LocalSettings;
Windows.Storage.StorageFolder localFolder = 
    Windows.Storage.ApplicationData.Current.LocalFolder;

// Setting in a container
Windows.Storage.ApplicationDataContainer container = 
   localSettings.CreateContainer("exampleContainer", Windows.Storage.ApplicationDataCreateDisposition.Always);

if (localSettings.Containers.ContainsKey("exampleContainer"))
{
   localSettings.Containers["exampleContainer"].Values["exampleSetting"] = "Hello Windows";
}

Excluir configurações e contêineres do aplicativo

Para excluir uma configuração simples de que seu aplicativo não precisa mais, use o método ApplicationDataContainerSettings.Remove . Este exemplo exclui a exampleSetting configuração local que criamos anteriormente.

Windows.Storage.ApplicationDataContainer localSettings = 
    Windows.Storage.ApplicationData.Current.LocalSettings;
Windows.Storage.StorageFolder localFolder = 
    Windows.Storage.ApplicationData.Current.LocalFolder;

// Delete simple setting

localSettings.Values.Remove("exampleSetting");

Para excluir uma configuração composta, use o método ApplicationDataCompositeValue.Remove . Este exemplo exclui a configuração composta local exampleCompositeSetting que criamos em um exemplo anterior.

Windows.Storage.ApplicationDataContainer localSettings = 
    Windows.Storage.ApplicationData.Current.LocalSettings;
Windows.Storage.StorageFolder localFolder = 
    Windows.Storage.ApplicationData.Current.LocalFolder;

// Delete composite setting

localSettings.Values.Remove("exampleCompositeSetting");

Para eliminar um contêiner, chame o método ApplicationDataContainer.DeleteContainer. Este exemplo exclui o contêiner de configurações locais exampleContainer que criamos anteriormente.

Windows.Storage.ApplicationDataContainer localSettings = 
    Windows.Storage.ApplicationData.Current.LocalSettings;
Windows.Storage.StorageFolder localFolder = 
    Windows.Storage.ApplicationData.Current.LocalFolder;

// Delete container

localSettings.DeleteContainer("exampleContainer");

Controle de versão dos dados da aplicação

Opcionalmente, você pode fazer a versão dos dados do aplicativo para seu aplicativo. Isso permitiria que você criasse uma versão futura do seu aplicativo que alterasse o formato dos dados do aplicativo sem causar problemas de compatibilidade com a versão anterior do seu aplicativo. O aplicativo verifica a versão dos dados do aplicativo no repositório de dados e, se a versão for menor do que a versão esperada, o aplicativo deve atualizar os dados do aplicativo para o novo formato e atualizar a versão. Para obter mais informações, consulte a propriedadeApplication.Version e o método ApplicationData.SetVersionAsync .

Artigos relacionados

• Windows.Storage.ApplicationData
• Windows.Storage.ApplicationData.RoamingSettings
• Windows.Storage.ApplicationData.RoamingFolder
• Windows.Storage.ApplicationData.RoamingStorageQuota
• Windows.Storage.ApplicationDataCompositeValue