ApplicationDataCreateDisposition enumeration

Specifies creation options for application data containers.

Syntax

var value = Windows.Storage.ApplicationDataCreateDisposition.always;

Attributes

VersionAttribute(NTDDI_WIN8)

Members

The ApplicationDataCreateDisposition enumeration has these members.

Remarks

Windows Phone 8

This API is not implemented and will throw an exception if called.

Examples

Call the ApplicationDataContainer.CreateContainer | createContainer method to create a settings container. This example creates a settings container named exampleContainer and adds a setting named exampleSetting. The Always | always value from the ApplicationDataCreateDisposition enumeration indicates that the container should be created if it does not already exist.

Use the ApplicationDataContainer.Values | values property to access the exampleSetting setting in the exampleContainer container.

Call the ApplicationDataContainer.DeleteContainer | deleteContainer method to delete the exampleContainer settings container when you have finished with it.

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");

Requirements

See also

Tasks

Quickstart: Local application data (JavaScript)

Quickstart: Local application data (C#/VB/C++)

Quickstart: Roaming application data (JavaScript)

Quickstart: Roaming application data (C#/VB/C++)

Concepts

Application data overview

Reference

ApplicationDataContainer.CreateContainer

Build date: 2/25/2013