ApplicationDataContainer ApplicationDataContainer ApplicationDataContainer ApplicationDataContainer Class

Definition

public : sealed class ApplicationDataContainer : IApplicationDataContainerpublic sealed class ApplicationDataContainer : IApplicationDataContainerPublic NotInheritable Class ApplicationDataContainer Implements IApplicationDataContainer// You can use this class in JavaScript.

Attributes

ContractVersionAttribute DualApiPartitionAttribute MarshalingBehaviorAttribute

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

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

Dim localSettings As Windows.Storage.ApplicationDataContainer = Windows.Storage.ApplicationData.Current.LocalSettings

' Create a setting in a container

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

If localSettings.Containers.ContainsKey("exampleContainer") Then
    localSettings.Containers("exampleContainer").Values("exampleSetting") = "Hello Windows"
End If

' Read data from a setting in a container

Dim hasContainer As Boolean = localSettings.Containers.ContainsKey("exampleContainer")
Dim hasSetting As Boolean = False

If hasContainer Then
    hasSetting = localSettings.Containers("exampleContainer").Values.ContainsKey("exampleSetting")
End If

' Delete a container

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

Remarks

The Values property gets an ApplicationDataContainerSettings object that provides access to the settings stored in the container.

public : IMapView<string, ApplicationDataContainer> Containers { get; }public IReadOnlyDictionary<string, ApplicationDataContainer> Containers { get; }Public ReadOnly Property Containers As IReadOnlyDictionary<string, ApplicationDataContainer>// You can use this property in JavaScript.

public : ApplicationDataLocality Locality { get; }public ApplicationDataLocality Locality { get; }Public ReadOnly Property Locality As ApplicationDataLocality// You can use this property in JavaScript.

public : PlatForm::String Name { get; }public string Name { get; }Public ReadOnly Property Name As string// You can use this property in JavaScript.

public : IPropertySet Values { get; }public IPropertySet Values { get; }Public ReadOnly Property Values As IPropertySet// You can use this property in JavaScript.

public : ApplicationDataContainer CreateContainer(PlatForm::String name, ApplicationDataCreateDisposition disposition)public ApplicationDataContainer CreateContainer(String name, ApplicationDataCreateDisposition disposition)Public Function CreateContainer(name As String, disposition As ApplicationDataCreateDisposition) As ApplicationDataContainer// You can use this method in JavaScript.

public : void DeleteContainer(PlatForm::String name)public void DeleteContainer(String name)Public Function DeleteContainer(name As String) As void// You can use this method in JavaScript.

See Also

• Quickstart: Local application data (JavaScript)
• Store and retrieve settings and other app data
• Quickstart: Roaming application data (JavaScript)
• Store and retrieve settings and other app data
• Store and retrieve settings and other app data
• Application data sample
• Application data sample (Windows 10)