Condividi tramite


ApplicationDataContainer Classe

Definizione

Rappresenta un contenitore per le impostazioni dell'app. I metodi e le proprietà di questa classe supportano la creazione, l'eliminazione, l'enumerazione e l'attraversamento della gerarchia dei contenitori.

public ref class ApplicationDataContainer sealed
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
/// [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
[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
Public NotInheritable Class ApplicationDataContainer
Implements IDisposable
Ereditarietà
Object Platform::Object IInspectable ApplicationDataContainer
Attributi
Implementazioni

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Chiamare il metodo ApplicationDataContainer.CreateContainer per creare un contenitore di impostazioni o per restituire un contenitore esistente. In questo esempio viene creato un contenitore di impostazioni denominato exampleContainer e viene aggiunta un'impostazione denominata exampleSetting. Il valore Always dell'enumerazione ApplicationDataCreateDisposition indica che il contenitore deve essere creato se non esiste già.

Utilizzare la proprietà ApplicationDataContainer.Values per accedere all'impostazione exampleSetting nel exampleContainer contenitore.

Chiamare il metodo ApplicationDataContainer.DeleteContainer per eliminare il exampleContainer contenitore delle impostazioni al termine dell'operazione.

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")

Commenti

Nota

Non è disponibile alcun contenitore di impostazioni per l'archivio dati temporaneo dell'app.

La proprietà Values ottiene un oggetto ApplicationDataContainerSettings che fornisce l'accesso alle impostazioni archiviate nel contenitore.

Proprietà

Containers

Ottiene i contenitori di impostazioni dell'applicazione figlio di questo contenitore di impostazioni dell'applicazione.

Locality

Ottiene il tipo (locale o roaming) dell'archivio dati dell'app associato al contenitore delle impostazioni corrente.

Name

Ottiene il nome del contenitore delle impostazioni correnti.

Values

Ottiene un oggetto che rappresenta le impostazioni in questo contenitore di impostazioni.

Metodi

Close()

Nota

Questo membro non è implementato in C#.

CreateContainer(String, ApplicationDataCreateDisposition)

Crea o apre il contenitore delle impostazioni specificato nel contenitore delle impostazioni correnti.

DeleteContainer(String)

Elimina il contenitore delle impostazioni specificato, i relativi subcontainer e tutte le impostazioni dell'applicazione nella gerarchia.

Dispose()

Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.

Si applica a

Vedi anche