ApplicationDataContainer Classe

Definição

Namespace:

Windows.Storage

Representa um contêiner para as configurações do aplicativo. Os métodos e as propriedades dessa classe dão suporte à criação, exclusão, enumeração e passagem da hierarquia de contêineres.

public ref class ApplicationDataContainer sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ApplicationDataContainer final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ApplicationDataContainer : System.IDisposable

Public NotInheritable Class ApplicationDataContainer
Implements IDisposable

Herança

Object Platform::Object IInspectable ApplicationDataContainer

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IClosable IDisposable

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Chame o método ApplicationDataContainer.CreateContainer para criar um contêiner de configurações ou para retornar um contêiner existente. Este exemplo cria um contêiner de configurações chamado exampleContainer e adiciona uma configuração chamada exampleSetting. O valor Always da enumeração ApplicationDataCreateDisposition indica que o contêiner deve ser criado se ainda não existir.

Use a propriedade ApplicationDataContainer.Values para acessar a exampleSetting configuração no exampleContainer contêiner.

Chame o método ApplicationDataContainer.DeleteContainer para excluir o exampleContainer contêiner de configurações quando tiver terminado com ele.

Windows.Storage.ApplicationDataContainer localSettings = Windows.Storage.ApplicationData.Current.LocalSettings;

// Create a 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!";
}

// Read data from a setting in a container

bool hasContainer = localSettings.Containers.ContainsKey("exampleContainer");
bool hasSetting = false;

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

// Delete a container

localSettings.DeleteContainer("exampleContainer");

Windows::Storage::ApplicationDataContainer localSettings{
    Windows::Storage::ApplicationData::Current().LocalSettings() };

// Create a setting in a container.
Windows::Storage::ApplicationDataContainer container{
    localSettings.CreateContainer(L"exampleContainer", Windows::Storage::ApplicationDataCreateDisposition::Always) };

if (localSettings.Containers().HasKey(L"exampleContainer"))
{
    auto values{ localSettings.Containers().Lookup(L"exampleContainer").Values() };
    values.Insert(L"exampleSetting", winrt::box_value(L"Hello, Windows!"));
}

// Read data from a setting in a container.
bool hasContainer{ localSettings.Containers().HasKey(L"exampleContainer") };
bool hasSetting{ false };

if (hasContainer)
{
    auto values{ localSettings.Containers().Lookup(L"exampleContainer").Values() };
    hasSetting = values.HasKey(L"exampleSetting");
}

// Delete a container.
localSettings.DeleteContainer(L"exampleContainer");

ApplicationDataContainer^ localSettings = ApplicationData::Current->LocalSettings;

// Create a setting in a container

ApplicationDataContainer^ container = 
   localSettings->CreateContainer("exampleContainer", ApplicationDataCreateDisposition::Always);

if (localSettings->Containers->HasKey("exampleContainer"))
{
   auto values = localSettings->Containers->Lookup("exampleContainer")->Values;
   values->Insert("exampleSetting", "Hello, Windows!");
}

// Read data from a setting in a container

bool hasContainer = localSettings->Containers->HasKey("exampleContainer");
bool hasSetting = false;

if (hasContainer)
{
   auto values = localSettings->Containers->Lookup("exampleContainer")->Values;
   hasSetting = values->HasKey("exampleSetting");
}

// Delete a container

localSettings->DeleteContainer("exampleContainer");

Dim localSettings As Windows.Storage.ApplicationDataContainer = Windows.Storage.ApplicationData.Current.LocalSettings

' Create a setting in a container

Dim container As Windows.Storage.ApplicationDataContainer = 
   localSettings.CreateContainer("exampleContainer", Windows.Storage.ApplicationDataCreateDisposition.Always)

If localSettings.Containers.ContainsKey("exampleContainer") Then
    localSettings.Containers("exampleContainer").Values("exampleSetting") = "Hello, Windows!"
End If

' Read data from a setting in a container

Dim hasContainer As Boolean = localSettings.Containers.ContainsKey("exampleContainer")
Dim hasSetting As Boolean = False

If hasContainer Then
    hasSetting = localSettings.Containers("exampleContainer").Values.ContainsKey("exampleSetting")
End If

' Delete a container

localSettings.DeleteContainer("exampleContainer")

Comentários

Observação

Não há nenhum contêiner de configurações para o armazenamento de dados de aplicativo temporário.

A propriedade Values obtém um objeto ApplicationDataContainerSettings que fornece acesso às configurações armazenadas no contêiner.

Propriedades

Containers	Obtém os contêineres de configurações de aplicativo filho deste contêiner de configurações de aplicativo.
Locality	Obtém o tipo (local ou roaming) do repositório de dados do aplicativo associado ao contêiner de configurações atual.
Name	Obtém o nome do contêiner de configurações atual.
Values	Obtém um objeto que representa as configurações neste contêiner de configurações.

Métodos

Close()	Observação Esse membro não é implementado em C#.
CreateContainer(String, ApplicationDataCreateDisposition)	Cria ou abre o contêiner de configurações especificado no contêiner de configurações atual.
DeleteContainer(String)	Exclui o contêiner de configurações especificado, seus subcontenentes e todas as configurações de aplicativo na hierarquia.
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados.

Confira também

• ApplicationData
• ApplicationDataCompositeValue
• ApplicationDataContainerSettings
• Armazene e recupere configurações e outros dados de aplicativo
• Amostra de dados de aplicativos