ApplicationDataContainer Class

表示應用程式設定的容器。 這個類別的方法和屬性支援建立、 刪除、 列舉及周遊容器階層。

語法


var applicationDataContainer = applicationData.localSettings;
var applicationDataContainer = applicationData.roamingSettings;

屬性

[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

這個應用程式開發介面不會實作,而且如果呼叫的話,會擲回例外狀況。請參閱 Windows Phone 執行階段 API

範例

呼叫 ApplicationDataContainer.CreateContainer | createContainer 方法,建立設定容器。這個範例會建立名為 exampleContainer 的設定容器,並加入名為 exampleSetting 的設定。來自 ApplicationDataCreateDisposition 列舉的 Always | always 值表示如果容器不存在就應該建立容器。

使用 ApplicationDataContainer.Values | values 屬性存取 exampleContainer 容器中的 exampleSetting 設定。

當您完成使用後,請呼叫 ApplicationDataContainer.DeleteContainer | deleteContainer 方法刪除 exampleContainer 設定容器。


var applicationData = Windows.Storage.ApplicationData.current;

var localSettings = applicationData.localSettings;

// Create a setting in a container

var container = localSettings.createContainer("exampleContainer", 
    Windows.Storage.ApplicationDataCreateDisposition.Always);

if (localSettings.containers.hasKey("exampleContainer"))
{
    localSettings.containers.lookup("exampleContainer").values["exampleSetting"] = "Hello Windows";
}

// Read data from a setting in a container

var hasContainer = localSettings.containers.hasKey("exampleContainer");

if (hasContainer)
{
    // Access data in: 
    //   localSettings.containers.lookup("exampleContainer").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
範例
應用程式資料範例

 

 

顯示:
© 2014 Microsoft