ApplicationDataContainer Class

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 le parcours de la hiérarchie du conteneur.

Syntaxe


var applicationDataContainer = applicationData.localSettings;
var applicationDataContainer = applicationData.roamingSettings;

Attributs

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Version(0x06020000)]

Membres

ApplicationDataContainerClasse comporte les types de membres suivants :

Méthodes

The ApplicationDataContainer Classe comporte les méthodes suivantes. Avec C#, Visual Basic et C++, il hérite également des méthodes de Object Classe.

MéthodeDescription
CreateContainer Creates or opens the specified settings container in the current settings container.
DeleteContainer Deletes the specified settings container, its subcontainers, and all application settings in the hierarchy.

 

Propriétés

ApplicationDataContainerClasse contient les propriétés suivantes.

PropriétéType d’accèsDescription

Containers

Lecture seuleGets the child application settings containers of this application settings container.

Locality

Lecture seuleGets the type (local or roaming) of the app data store that is associated with the current settings container.

Name

Lecture seuleGets the name of the current settings container.

Values

Lecture seuleGets an object that represents the settings in this settings container.

 

Remarques

Remarque  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 permet d'accéder aux paramètres stockés dans le conteneur.

Windows Phone 8

Cette API n'est pas implémentée et lève une exception si elle est appelée. Consultez API de runtime Windows Phone.

Exemples

Appelle la méthode ApplicationDataContainer.CreateContainer | createContainer pour créer un conteneur de paramètres. Cet exemple crée un conteneur de paramètres nommé exampleContainer et ajoute un paramètre nommé exampleSetting. La valeur Always | always de l'énumération ApplicationDataCreateDisposition indique que le conteneur doit être créé s'il n'existe pas.

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

Appelez la méthode ApplicationDataContainer.DeleteContainer | deleteContainer pour supprimer le conteneur de paramètres exampleContainer lorsque vous n'en avez plus besoin.


var applicationData = Windows.Storage.ApplicationData.current;

var localSettings = applicationData.localSettings;

// Create a setting in a container

var container = localSettings.createContainer("exampleContainer", 
    Windows.Storage.ApplicationDataCreateDisposition.Always);

if (localSettings.containers.hasKey("exampleContainer"))
{
    localSettings.containers.lookup("exampleContainer").values["exampleSetting"] = "Hello Windows";
}

// Read data from a setting in a container

var hasContainer = localSettings.containers.hasKey("exampleContainer");

if (hasContainer)
{
    // Access data in: 
    //   localSettings.containers.lookup("exampleContainer").values.hasKey("exampleSetting");
}

// Delete a container

localSettings.deleteContainer("exampleContainer");

Configuration requise

Client minimal pris en charge

Windows 8 [Applications du Windows Store, applications de bureau]

Serveur minimal pris en charge

Windows Server 2012 [Applications du Windows Store, applications de bureau]

Téléphone minimal pris en charge

Windows Phone 8 [non implémenté, voir Remarques]

Espace de noms

Windows.Storage
Windows::Storage [C++]

Métadonnées

Windows.winmd

DLL

Windows.Storage.ApplicationData.dll

Voir aussi

Tâches
Démarrage rapide : données des applications locales (JavaScript)
Démarrage rapide : données des applications locales (C#/VB/C++)
Démarrage rapide : données des applications itinérantes (JavaScript)
Démarrage rapide : données d'application itinérantes (C#/VB/C++)
Concepts
Présentation des données de l'application
Référence
ApplicationData
ApplicationDataCompositeValue
ApplicationDataContainerSettings
Exemples
Exemple de données d'application

 

 

Afficher:
© 2014 Microsoft