导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

ApplicationData.RoamingFolder | roamingFolder Property

获取漫游应用程序数据存储区中的根文件夹。

语法


var roamingFolder = applicationData.roamingFolder;

属性值

类型: StorageFolder

包含这些文件的文件系统文件夹。

备注

您必须遵守同步引擎对文件名约定的限制以确保漫游文件夹中的项可以漫游。请确保您的文件名和文件夹名的开头不包含空格。同步引擎可能限制能够漫游的设置和文件的总大小。

使用 "ms-appdata:///roaming/" 协议,可以访问漫游应用程序数据存储区的文件。例如:

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

Windows Phone 8

此 API 不实现,但是调用时会引发异常。请参见 Windows Phone 运行时 API

示例

使用文件 API,如 Windows.Storage.StorageFolder.CreateFileAsync | createFileAsyncWindows.Storage.FileIO.WriteTextAsync | writeTextAsync,在漫游应用程序数据存储区创建和更新文件。此示例在 roamingFolder 容器中创建了名为 dataFile.txt 的文件并将当前的日期和时间编写到该文件。CreationCollisionOption 枚举中的 ReplaceExisting | replaceExisting 值指示应替换已存在的文件。

接下来,此示例将打开 dataFile.txt 文件从该文件中使用 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
      });
}

要求

最低受支持的客户端

Windows 8

最低受支持的服务器

Windows Server 2012

最低受支持的电话

Windows Phone 8 [未执行,请参阅“备注”]

命名空间

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

元数据

Windows.winmd

DLL

Windows.Storage.ApplicationData.dll

另请参阅

任务
快速入门:漫游应用程序数据 (JavaScript)
快速入门:漫游应用程序数据 (C#/VB/C++)
概念
应用程序数据概述
引用
ApplicationData

 

 

显示:
© 2014 Microsoft