此页面有用吗?
您对此内容的反馈非常重要。 请告诉我们您的想法。
更多反馈?
1500 个剩余字符
MSDN Library
信息
您所需的主题如下所示。但此主题未包含在此库中。

ApplicationDataContainer Class

表示应用程序设置的容器。此类的方法和属性支持创建、删除、枚举以及遍历容器层次结构。

语法


public ref class ApplicationDataContainer sealed 

特性

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Version(0x06020000)]

成员

ApplicationDataContainer类 具有以下类型的成员:

方法

The ApplicationDataContainer 类 具有以下方法。 使用 C#、Visual Basic 和 C++,它还可以继承以下内容中的方法 Object 类.

方法描述
CreateContainer Creates or opens the specified settings container in the current settings container.
DeleteContainer Deletes the specified settings container, its subcontainers, and all application settings in the hierarchy.

 

属性

ApplicationDataContainer类 具有以下属性。

属性访问类型描述

Containers

只读Gets the child application settings containers of this application settings container.

Locality

只读Gets the type (local or roaming) of the app data store that is associated with the current settings container.

Name

只读Gets the name of the current settings container.

Values

只读Gets an object that represents the settings in this settings container.

 

备注

注意  临时应用程序数据存储没有设置容器。

Values 属性获取可访问容器存储设置的 ApplicationDataContainerSettings 对象。

Windows Phone 8

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

示例

调用 ApplicationDataContainer.CreateContainer | createContainer 方法,以创建设置容器。此示例创建名为 exampleContainer 的设置容器并添加名为 exampleSetting 的设置。如果尚不存在,则来自 ApplicationDataCreateDisposition 枚举的 Always | always 值指示应创建容器。

使用 ApplicationDataContainer.Values | values 属性以访问 exampleContainer 容器中的 exampleSetting 设置。

调用 ApplicationDataContainer.DeleteContainer | deleteContainer 方法以在完成时删除 exampleContainer 设置容器。


ApplicationDataContainer^ localSettings = ApplicationData::Current->LocalSettings;

// Create a setting in a container

ApplicationDataContainer^ container = 
   localSettings->CreateContainer("exampleContainer", ApplicationDataCreateDisposition::Always);

if (localSettings->Containers->HasKey("exampleContainer"))
{
   auto values = localSettings->Containers->Lookup("exampleContainer")->Values;
   values->Insert("exampleSetting", "Hello Windows");
}

// Read data from a setting in a container

bool hasContainer = localSettings->Containers->HasKey("exampleContainer");
bool hasSetting = false;

if (hasContainer)
{
   auto values = localSettings->Containers->Lookup("exampleContainer")->Values;
   hasSetting = values->HasKey("exampleSetting");
}

// Delete a container

localSettings->DeleteContainer("exampleContainer");

要求

最低受支持的客户端

Windows 8 [Windows 应用商店应用, 桌面应用]

最低受支持的服务器

Windows Server 2012 [Windows 应用商店应用, 桌面应用]

最低受支持的电话

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

命名空间

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

元数据

Windows.winmd

DLL

Windows.Storage.ApplicationData.dll

另请参阅

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

 

 

显示:
© 2015 Microsoft