ApplicationDataContainer Classe

Définition

Espace de noms:

Windows.Storage

Représente un conteneur pour les paramètres d’application. Les méthodes et propriétés de cette classe prennent en charge la création, la suppression, l’énumération et la traversée de la hiérarchie de conteneur.

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

Héritage

Object Platform::Object IInspectable ApplicationDataContainer

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

IClosable IDisposable

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Appelez la méthode ApplicationDataContainer.CreateContainer pour créer un conteneur de paramètres ou pour retourner un conteneur existant. Cet exemple crée un conteneur de paramètres nommé exampleContainer et ajoute un paramètre nommé exampleSetting. La valeur Always de l’énumération ApplicationDataCreateDisposition indique que le conteneur doit être créé s’il n’existe pas déjà.

Utilisez la propriété ApplicationDataContainer.Values pour accéder au exampleSetting paramètre dans le exampleContainer conteneur.

Appelez la méthode ApplicationDataContainer.DeleteContainer pour supprimer le exampleContainer conteneur de paramètres lorsque vous avez terminé.

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

Remarques

Notes

Il n’existe aucun conteneur de paramètres pour le magasin de données d’application temporaire.

La propriété Values obtient un objet ApplicationDataContainerSettings qui fournit l’accès aux paramètres stockés dans le conteneur.

Propriétés

Containers	Obtient les conteneurs de paramètres d’application enfants de ce conteneur de paramètres d’application.
Locality	Obtient le type (local ou itinérant) du magasin de données d’application associé au conteneur de paramètres actuel.
Name	Obtient le nom du conteneur de paramètres actuel.
Values	Obtient un objet qui représente les paramètres dans ce conteneur de paramètres.

Méthodes

Close()	Notes Ce membre n’est pas implémenté en C#.
CreateContainer(String, ApplicationDataCreateDisposition)	Crée ou ouvre le conteneur de paramètres spécifié dans le conteneur de paramètres actuel.
DeleteContainer(String)	Supprime le conteneur de paramètres spécifié, ses sous-conteneurs et tous les paramètres d’application dans la hiérarchie.
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.

Voir aussi

• ApplicationData
• ApplicationDataCompositeValue
• ApplicationDataContainerSettings
• Stocker et récupérer des paramètres et autres données d’application
• Exemple de données d’application