Démarrage rapide : données d’application locales (HTML)

[ Cet article est destiné aux développeurs de Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]

Découvrez le stockage et la récupération de paramètres et de fichiers à partir du magasin de données d’application locales.

Obtenir les conteneurs pour les paramètres et les fichiers de l’application

Utilisez la propriété ApplicationData.localSettings pour obtenir les paramètres d’un objet ApplicationDataContainer. Utilisez la propriété ApplicationData.localFolder pour obtenir les fichiers placés dans un objet StorageFolder.

var localSettings = applicationData.localSettings;
var localFolder = applicationData.localFolder;

Les étapes suivantes s’appuient sur les variables localSettings et localFolder de cette étape.

Écrire des données dans un paramètre

Utilisez la propriété ApplicationDataContainer.values pour accéder aux paramètres inclus dans le conteneur localSettings abordé à l’étape précédente. Cet exemple crée un paramètre intitulé exampleSetting.

// Simple setting

localSettings.values["exampleSetting"] = "Hello Windows";

Un objet ApplicationDataCompositeValue contient les paramètres devant être accédés atomiquement. Cet exemple crée un paramètre composite intitulé exampleCompositeSetting, puis l’ajoute au conteneur localSettings.

// Composite setting

var composite = new Windows.Storage.ApplicationDataCompositeValue();
composite["intVal"] = 1;
composite["strVal"] = "string";

localSettings.values["exampleCompositeSetting"] = composite;

Appelez la méthode ApplicationDataContainer.CreateContainer pour créer un conteneur de paramètres. Cet exemple crée un conteneur de paramètres intitulé exampleContainer, puis ajoute un paramètre appelé exampleSetting. La valeur Always de l’énumération ApplicationDataCreateDisposition indique que le conteneur est créé s’il n’existe pas.

// 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";
}

Lire des données d’un paramètre

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

// Simple setting

var value = localSettings.values["exampleSetting"];
        
if (!value)
{
    // No data
}
else
{
    // Access data in value
}

Utilisez la propriété ApplicationDataContainer.values pour accéder au paramètre exampleCompositeSetting dans le conteneur localSettings.

// Composite setting

var composite = localSettings.values["exampleCompositeSetting"];

if (!composite)
{
    // No data
}
else
{
    // Access data in composite["intVal"] and composite["strVal"]
}

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

// Setting in a container

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

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

Écrire des données dans un fichier

Faites appel aux API, telles que Windows.Storage.StorageFolder.createFileAsync et Windows.Storage.FileIO.writeTextAsync, pour créer et mettre à jour un fichier dans le magasin de données d’application locales. Cet exemple crée un fichier appelé dataFile.txt dans le conteneur localFolder, puis écrit la date et l’heure actuelles dans le fichier. La valeur replaceExisting de l’énumération CreationCollisionOption indique de remplacer le fichier s’il existe.

function writeTimestamp() {
   localFolder.createFileAsync("dataFile.txt", Windows.Storage.CreationCollisionOption.replaceExisting)
      .then(function (sampleFile) {
         var formatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter("longtime");
         var timestamp = formatter.format(new Date());

         return Windows.Storage.FileIO.writeTextAsync(sampleFile, timestamp);
      }).done(function () {      
      });
}

Lire des données d’un fichier

Utilisez les API de fichier, telles que Windows.Storage.StorageFolder.getFileAsync, Windows.Storage.StorageFile.GetFileFromApplicationUriAsync et Windows.Storage.FileIO.readTextAsync pour ouvrir et lire un fichier dans le magasin de données d’application locales. Cet exemple ouvre le fichier dataFile.txt créé à l’étape précédente, puis lit la date du fichier. La valeur openIfExists de l’énumération CreationCollisionOption indique que le fichier doit exister. Pour obtenir des détails sur le chargement de ressources de fichiers à partir de différents emplacements, voir Comment charger des ressources de fichiers.

function readTimestamp() {
   localFolder.getFileAsync("dataFile.txt")
      .then(function (sampleFile) {
         return Windows.Storage.FileIO.readTextAsync(sampleFile);
      }).done(function (timestamp) {
         // Data is contained in timestamp
      }, function () {
         // Timestamp not found
      });
}

Supprimer des paramètres après leur utilisation

Appelez la méthode ApplicationDataContainerSettings.remove pour supprimer le paramètre exampleSetting lorsque vous n’en avez plus besoin.

// Simple setting

localSettings.values.remove("exampleSetting");

Appelez la méthode ApplicationDataCompositeValue.remove pour supprimer le paramètre composite exampleCompositeSetting lorsque vous n’en avez plus besoin.

// Delete composite setting

localSettings.values.remove("exampleCompositeSetting");

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

// Delete container

localSettings.deleteContainer("exampleContainer");

Rubriques associées

Tâche

Comment charger des ressources de fichiers

Démarrage rapide : données d’application itinérantes

Démarrage rapide : données d’application temporaires

Conceptuel

Accès aux données de l’application à l’aide de Windows Runtime

Référence

Windows.Storage.ApplicationData

Windows.Storage.ApplicationDataCompositeValue

Windows.Storage.ApplicationDataContainer

Windows.Storage.ApplicationDataContainerSettings

Exemples

Exemple de données d’application