ApplicationDataCreateDisposition Enumeration

Задает параметры создания для контейнеров данных приложения.

Синтаксис


public enum class ApplicationDataCreateDisposition

Атрибуты

[Version(0x06020000)]

Члены

ApplicationDataCreateDispositionПеречисление содержит следующие члены.

ЧленЗначениеОписание
Always | always0

Всегда активировать контейнер. Если представленный объектом ресурс не существует, создать его.

Existing | existing1

Контейнер следует активировать только в том случае, если представляемый им ресурс уже существует.

Замечания

Windows Phone 8

Этот API не реализован, и в случае его вызова возникнет исключение. См. API среды выполнения Windows Phone.

Примеры

Вызовите метод ApplicationDataContainer.CreateContainer | createContainer, чтобы создать контейнер параметров. В этом примере создается контейнер параметров с именем exampleContainer и добавляется параметр с именем exampleSetting. Значение Always | always из перечисления ApplicationDataCreateDisposition указывает, что если контейнер не существует, он должен быть создан.

Используйте свойство ApplicationDataContainer.Values | values для доступа к параметру exampleSetting в контейнере exampleContainer.

Вызовите метод 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