ApplicationDataContainer Classe

Definizione

Spazio dei nomi:

Windows.Storage

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 : 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

Ereditarietà

Object Platform::Object IInspectable ApplicationDataContainer

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni

IClosable IDisposable

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.

Vedi anche

• ApplicationData
• ApplicationDataCompositeValue
• ApplicationDataContainerSettings
• Archiviare e recuperare le impostazioni e altri dati dell'app
• Esempio di dati applicazione