LocalSettings | localSettings - Eigenschaft

ApplicationData.LocalSettings | localSettings Property

Ruft den Container der Anwendungseinstellungen im lokalen App-Datenspeicher ab.

Syntax


public:
property ApplicationDataContainer^ LocalSettings { 
   ApplicationDataContainer^ get();
}

Eigenschaftenwert

Typ: ApplicationDataContainer

Der Container "Anwendungseinstellungen".

Anmerkungen

Der Name jeder Einstellung kann höchstens 255 Buchstaben lang sein. Jede Einstellung kann bis zu 8 KB groß sein. Jede zusammengesetzte Einstellung kann bis zu 64 KB groß sein.

Die Windows-Runtime-Datentypen werden für App-Einstellungen unterstützt.

Windows Phone 8

Diese API wird nicht implementiert und löst beim Aufruf eine Ausnahme aus. Weitere Informationen finden Sie unter Windows Phone Runtime API.

Beispiele

Verwenden Sie die LocalSettings | localSettings-Eigenschaft, um die Einstellungen in einem ApplicationDataContainer-Objekt abzurufen. Rufen Sie mit der ApplicationDataContainer.Values | values-Eigenschaft die Einstellungen im localSettings-Container auf. Dieses Beispiel erstellt und liest eine Einstellung namens exampleSetting.

Rufen Sie die ApplicationDataContainerSettings.Remove | remove-Methode auf, um die Einstellung exampleSetting zu löschen, wenn Sie sie beendet haben.


ApplicationDataContainer^ localSettings = ApplicationData::Current->LocalSettings;

// Create a simple setting

auto values = localSettings->Values;
values->Insert("exampleSetting", dynamic_cast<PropertyValue^>(PropertyValue::CreateString("Hello Windows")));

// Read data from a simple setting

auto values = localSettings->Values;
String^ value = safe_cast<String^>(localSettings->Values->Lookup("exampleSetting"));

if (!value)
{
    // No data
}
else
{
    // Access data in value
}

// Delete a simple setting

values->Remove("exampleSetting");

Anforderungen

Unterstützte Mindestversion (Client)

Windows 8

Unterstützte Mindestversion (Server)

Windows Server 2012

Unterstützte Mindestversion (Telefon)

Windows Phone 8 [nicht implementiert, siehe Hinweise]

Namespace

Windows.Storage
Windows::Storage [C++]

Metadaten

Windows.winmd

DLL

Windows.Storage.ApplicationData.dll

Weitere Informationen

Aufgaben
Schnellstart: Lokale Anwendungsdaten (JavaScript)
Schnellstart: Lokale Anwendungsdaten (C#/VB/C++)
Konzepte
Übersicht über Anwendungsdaten
Verweis
ApplicationData

 

 

Anzeigen:
© 2018 Microsoft