ApplicationDataCreateDisposition Enumeration

指定應用程式資料容器的建立選項。

語法


public enum class ApplicationDataCreateDisposition

屬性

[Version(0x06020000)]

成員

ApplicationDataCreateDisposition列舉 有這些成員。

成員說明
Always | always0

永遠啟用容器。如果物件表示的資源不存在,請加以建立。

Existing | existing1

只有在其所表示的資源已經存在時,才啟用容器。

備註

Windows Phone 8

這個應用程式開發介面不會實作,而且如果呼叫的話,會擲回例外狀況。請參閱 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 Server 2012

最低支援的電話

Windows Phone 8 [未實作,請見備註]

命名空間

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

中繼資料

Windows.winmd

另請參閱

工作
快速入門:本機應用程式資料 (JavaScript)
快速入門:本機應用程式資料 (C#/VB/C++)
快速入門:漫遊應用程式資料 (JavaScript)
快速入門:漫遊應用程式資料 (C#/VB/C++)
概念
應用程式資料概觀
參考
ApplicationDataContainer.CreateContainer

 

 

顯示:
© 2015 Microsoft