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

ApplicationData.RoamingSettings | roamingSettings Property

获取漫游应用程序数据存储区中的应用程序设置容器。

语法


public:
property ApplicationDataContainer^ RoamingSettings { 
   ApplicationDataContainer^ get();
}

属性值

类型: ApplicationDataContainer

应用程序设置容器。

备注

每个设置的名称最长可为 255 字符。每个设置的大小可以多达 8K 字节,而每个复合设置的大小可以多达 64K 字节。同步引擎可能限制能够漫游的设置和文件的总大小。

为应用程序设置支持 Windows 运行时数据类型

Windows Phone 8

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

示例

使用 RoamingSettings | roamingSettings 属性可以获取在 ApplicationDataContainer 对象中的设置。使用 ApplicationDataContainer.Values | values 属性可以访问在 roamingSettings 容器中的设置。此示例创建并读取名为 exampleSetting 的设置。

调用 ApplicationDataContainerSettings.Remove | remove 方法以在完成时删除 exampleSetting 设置。


ApplicationDataContainer^ roamingSettings = ApplicationData::Current->RoamingSettings;

// Create a simple setting

auto values = roamingSettings->Values;
values->Insert("exampleSetting", dynamic_cast<PropertyValue^>(PropertyValue::CreateString("Hello World")));

// Read data from a simple setting

auto values = roamingSettings->Values;
String^ value = safe_cast<String^>(roamingSettings->Values->Lookup("exampleSetting"));

if (!value)
{
    // No data
}
else
{
    // Access data in value
}

// Delete a simple setting

values->Remove("exampleSetting");

要求

最低受支持的客户端

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

 

 

显示: