信息
您所需的主题如下所示。但此主题未包含在此库中。
此主题尚未评级 - 评价此主题

ApplicationData.RoamingFolder | roamingFolder Property

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

语法


public:
property StorageFolder^ RoamingFolder { 
   StorageFolder^ get();
}

属性值

类型: 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 创建并读取该日期。


StorageFolder^ roamingFolder = ApplicationData::Current->RoamingFolder;

// Write data to a file

void MainPage::WriteTimestamp()
{
   concurrency::task<StorageFile^> fileOperation = 
       roamingFolder->CreateFileAsync("dataFile.txt", CreateCollisionOption::ReplaceExisting);
   fileOperation.then([this](StorageFile^ sampleFile)
   {
      auto calendar = ref new Calendar;
      auto now = calendar->ToDateTime();
      auto formatter = ref new Windows::Globalization::DateTimeFormatting::DateTimeFormatter("longtime");

      return FileIO::WriteTextAsync(sampleFile, formatter->Format(now));
   }).then([this](task<void> previousOperation) {
      try {
         previousOperation.get();
      } catch (Platform::Exception^) {
         // Timestamp not written
      }
   });
}

// Read data from a file

void MainPage::ReadTimestamp()
{
   concurrency::task<StorageFile^> getFileOperation(roamingFolder->GetFileAsync("dataFile.txt"));
   getFileOperation.then([this](StorageFile^ file)
   {
      return FileIO::ReadTextAsync(file);
   }).then([this](concurrency::task<String^> previousOperation) {
      String^ timestamp;
 
      try {
         // Data is contained in timestamp
         timestamp = previousOperation.get();
      } catch (...) {
         // 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

 

 

本文是否对您有所帮助?
(1500 个剩余字符)
感谢您的反馈
显示:
© 2014 Microsoft. 版权所有。