ApplicationDataContainer.DeleteContainer | deleteContainer method

Deletes the specified settings container, its subcontainers, and all application settings in the hierarchy.

Syntax

applicationDataContainer.deleteContainer(name);

Parameters

name

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

The name of 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.

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

Build date: 2/25/2013