This topic has not yet been rated - Rate this topic

ApplicationDataContainer.CreateContainer | createContainer method

Creates or opens the specified settings container in the current settings container.

Syntax


public ApplicationDataContainer CreateContainer(
  string name, 
  ApplicationDataCreateDisposition disposition
)

Parameters

name

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

The name of the container.

disposition

Type: ApplicationDataCreateDisposition

One of the enumeration values.

Return value

Type: ApplicationDataContainer

The settings container.

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.

JavaScript

C++


Windows.Storage.ApplicationDataContainer localSettings = Windows.Storage.ApplicationData.Current.LocalSettings;

// Create a setting in a container

Windows.Storage.ApplicationDataContainer container = 
   localSettings.CreateContainer("exampleContainer", Windows.Storage.ApplicationDataCreateDisposition.Always);

if (localSettings.Containers.ContainsKey("exampleContainer"))
{
   localSettings.Containers["exampleContainer"].Values["exampleSetting"] = "Hello Windows";
}

// Read data from a setting in a container

bool hasContainer = localSettings.Containers.ContainsKey("exampleContainer");
bool hasSetting = false;

if (hasContainer)
{
   hasSetting = localSettings.Containers["exampleContainer"].Values.ContainsKey("exampleSetting");
}

// Delete a container

localSettings.DeleteContainer("exampleContainer");

Requirements

Minimum supported client	Windows 8
Minimum supported server	Windows Server 2012
Minimum supported phone	Windows Phone 8
Namespace	Windows.Storage Windows::Storage [C++]
Metadata	Windows.winmd
DLL	Windows.Storage.ApplicationData.dll