ApplicationData.RoamingFolder | roamingFolder Property

Obtient le dossier racine dans le magasin de données d'application itinérant.

Syntaxe


var roamingFolder = applicationData.roamingFolder;

Valeur de propriété

Type: StorageFolder

Dossier du système de fichiers qui contient les fichiers.

Remarques

Le moteur de synchronisation contient des restrictions sur les conventions de nom de fichier que vous devez suivre pour permettre aux éléments d'être itinérants dans le dossier d'itinérance. Assurez-vous que les noms de fichiers et de dossiers ne contiennent pas d'espace blanc au début. Le moteur de synchronisation peut limiter la taille totale des paramètres et des fichiers qui peuvent être itinérants.

Vous pouvez accéder aux fichiers du magasin de données d'application itinérant à l'aide du protocole "ms-appdata:///roaming/". Par exemple :

<img src="ms-appdata:///roaming/myFile.png" alt="" />

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

Utilisez les API de fichier, telles que Windows.Storage.StorageFolder.CreateFileAsync | createFileAsync et Windows.Storage.FileIO.WriteTextAsync | writeTextAsync, pour créer et mettre à jour un fichier dans le magasin de données d'application itinérant. Cet exemple crée un fichier nommé dataFile.txt dans le conteneur roamingFolder et écrit la date et l'heure actuelles dans le fichier. La valeur ReplaceExisting | replaceExisting de l'énumération CreationCollisionOption indique que le fichier doit être remplacé s'il existe déjà.

Ensuite, cet exemple ouvre le fichier dataFile.txt créé et lit la date du fichier à l'aide de Windows.Storage.FileIO.readTextAsync.


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

// Write data to a file

function writeTimestamp() {
   roamingFolder.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 () {      
      });
}

// Read data from a file

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

Configuration requise

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

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 d'application itinérantes (JavaScript)
Démarrage rapide : données des applications itinérantes (C#/VB/C++)
Concepts
Présentation des données de l'application
Référence
ApplicationData

 

 

Afficher:
© 2014 Microsoft