ApplicationDataContainer Klasse

Definition

Namespace:

Windows.Storage

Stellt einen Container für App-Einstellungen dar. Die Methoden und Eigenschaften dieser Klasse unterstützen das Erstellen, Löschen, Aufzählen und Durchlaufen der Containerhierarchie.

public ref class ApplicationDataContainer sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ApplicationDataContainer final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ApplicationDataContainer : System.IDisposable

Public NotInheritable Class ApplicationDataContainer
Implements IDisposable

Vererbung

Object Platform::Object IInspectable ApplicationDataContainer

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

IClosable IDisposable

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Rufen Sie die ApplicationDataContainer.CreateContainer-Methode auf, um einen Einstellungscontainer zu erstellen oder einen vorhandenen Container zurückzugeben. In diesem Beispiel wird ein Einstellungscontainer namens exampleContainer erstellt und eine Einstellung mit dem Namen exampleSettinghinzugefügt. Der Always-Wert aus der ApplicationDataCreateDisposition-Enumeration gibt an, dass der Container erstellt werden soll, wenn er noch nicht vorhanden ist.

Verwenden Sie die ApplicationDataContainer.Values-Eigenschaft , um auf die exampleSetting Einstellung im exampleContainer Container zuzugreifen.

Rufen Sie die ApplicationDataContainer.DeleteContainer-Methode auf, um den Einstellungscontainer exampleContainer zu löschen, wenn Sie ihn abgeschlossen haben.

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

Windows::Storage::ApplicationDataContainer localSettings{
    Windows::Storage::ApplicationData::Current().LocalSettings() };

// Create a setting in a container.
Windows::Storage::ApplicationDataContainer container{
    localSettings.CreateContainer(L"exampleContainer", Windows::Storage::ApplicationDataCreateDisposition::Always) };

if (localSettings.Containers().HasKey(L"exampleContainer"))
{
    auto values{ localSettings.Containers().Lookup(L"exampleContainer").Values() };
    values.Insert(L"exampleSetting", winrt::box_value(L"Hello, Windows!"));
}

// Read data from a setting in a container.
bool hasContainer{ localSettings.Containers().HasKey(L"exampleContainer") };
bool hasSetting{ false };

if (hasContainer)
{
    auto values{ localSettings.Containers().Lookup(L"exampleContainer").Values() };
    hasSetting = values.HasKey(L"exampleSetting");
}

// Delete a container.
localSettings.DeleteContainer(L"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");

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

Hinweise

Hinweis

Es gibt keinen Einstellungscontainer für den temporären App-Datenspeicher.

Die Values-Eigenschaft ruft ein ApplicationDataContainerSettings-Objekt ab, das Zugriff auf die im Container gespeicherten Einstellungen ermöglicht.

Eigenschaften

Containers	Ruft die container für untergeordnete Anwendungseinstellungen dieses Anwendungseinstellungscontainers ab.
Locality	Ruft den Typ (lokal oder roaming) des App-Datenspeichers ab, der dem aktuellen Einstellungscontainer zugeordnet ist.
Name	Ruft den Namen des aktuellen Einstellungscontainers ab.
Values	Ruft ein -Objekt ab, das die Einstellungen in diesem Einstellungscontainer darstellt.

Methoden

Close()	Hinweis Dieser Member ist in C# nicht implementiert.
CreateContainer(String, ApplicationDataCreateDisposition)	Erstellt oder öffnet den angegebenen Einstellungscontainer im aktuellen Einstellungscontainer.
DeleteContainer(String)	Löscht den angegebenen Einstellungscontainer, seine Untercontainer und alle Anwendungseinstellungen in der Hierarchie.
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.

Weitere Informationen

• ApplicationData
• ApplicationDataCompositeValue
• ApplicationDataContainerSettings
• Speichern und Abrufen von Einstellungen und anderen App-Daten
• Beispiel für Anwendungsdaten