ApplicationData Class

Permet d'accéder au magasin de données d'application. Les données des applications se composent des fichiers et des paramètres qui sont locaux, itinérants ou temporaires.

Syntaxe


var applicationData = Windows.Storage.ApplicationData;

Attributs

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

Membres

ApplicationDataClasse comporte les types de membres suivants :

Événements

ApplicationDataClasse comporte les événements suivants.

ÉvénementDescription
DataChanged Occurs when roaming application data is synchronized.

 

Méthodes

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

MéthodeDescription
ClearAsync() Removes all application data from the local, roaming, and temporary app data stores.
ClearAsync(ApplicationDataLocality) Removes all application data from the specified app data store.
SetVersionAsync Sets the version number of the application data in the app data store.
SignalDataChanged Sends a DataChanged | datachanged event to all registered event handlers.

 

Propriétés

ApplicationDataClasse contient les propriétés suivantes.

PropriétéType d’accèsDescription

Current

Lecture seuleProvides access to the app data store associated with the app's app package.

LocalFolder

Lecture seuleGets the root folder in the local app data store.

LocalSettings

Lecture seuleGets the application settings container in the local app data store.

RoamingFolder

Lecture seuleGets the root folder in the roaming app data store.

RoamingSettings

Lecture seuleGets the application settings container in the roaming app data store.

RoamingStorageQuota

Lecture seuleGets the maximum size of the data that can be synchronized to the cloud from the roaming app data store.

TemporaryFolder

Lecture seuleGets the root folder in the temporary app data store.

Version

Lecture seuleGets the version number of the application data in the app data store.

 

Remarques

ApplicationData fournit un stockage local, temporaire et itinérant pour les données d'application sur la base de chaque utilisateur. Utilisez cette classe pour conserver des données spécifiques aux applications d'une session à une autre et sur plusieurs appareils.

ApplicationData ne fournit pas l'accès aux fichiers dans un package d'application. Pour cela, utilisez Windows.ApplicationModel.Package.InstalledLocation.

ApplicationData.Current donne l'instance ApplicationData de l'application. Utilisez cette instance pour accéder au stockage des données d'application via l'une des propriétés suivantes :

Il existe trois principaux types de données d'application :

  • Local : stocké sur le périphérique et persiste entre les mises à jour.
  • Itinérance : copié vers d'autres appareils sur lesquels l'utilisateur a installé l'application.
  • Provisoire : peut être supprimé par le système à tout moment.

Les deux principaux types de stockage des données d'application sont :

  • Paramètres : stocke les données d'application sous forme de paires clé/valeur que vous pouvez organiser en ensembles imbriqués. Ces données sont stockées dans le Registre Windows.
  • Dossiers : stocke les données d'application comme fichiers sur le système de fichiers.

Vous pouvez stocker les données d'application dans des formats spécifiques à l'application, avec version. Pour plus d'informations, consultez Version et SetVersionAsync.

Pour plus d'informations sur l'utilisation de ces API, consultez Accès aux données d'application avec Windows Runtime.

Exemples

L'exemple de code suivant montre comment obtenir le conteneur de paramètres locaux de l'application.


var applicationData = Windows.Storage.ApplicationData.current;
var localSettings = applicationData.localSettings;

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

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 d'application itinérantes (JavaScript)
Démarrage rapide : données d'application itinérantes (C#/VB/C++)
Démarrage rapide : données d'application temporaires (JavaScript)
Démarrage rapide : données d'application temporaires (C#/VB/C++)
Concepts
Présentation des données de l'application
Indications
Instructions pour les données d'application d'itinérance
Instructions pour les paramètres d'application
Référence
ApplicationDataCompositeValue
ApplicationDataContainer
ApplicationDataContainerSettings
Exemples
Exemple de paramètres d'application
Exemple de données d'application

 

 

Afficher:
© 2014 Microsoft