ApplicationData.LocalSettings Eigenschaft

Definition

Namespace:

Windows.Storage

Ruft den Anwendungseinstellungencontainer im lokalen App-Datenspeicher ab.

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

ApplicationDataContainer LocalSettings();

public ApplicationDataContainer LocalSettings { get; }

var applicationDataContainer = applicationData.localSettings;

Public ReadOnly Property LocalSettings As ApplicationDataContainer

Eigenschaftswert

ApplicationDataContainer

Der Anwendungseinstellungencontainer.

Beispiele

Verwenden Sie die LocalSettings-Eigenschaft, um die Einstellungen in einem ApplicationDataContainer-Objekt abzurufen. Verwenden Sie die ApplicationDataContainer.Values-Eigenschaft , um auf die Einstellungen im localSettings Container zuzugreifen. In diesem Beispiel wird eine Einstellung mit dem Namen exampleSettingerstellt und gelesen.

Rufen Sie die ApplicationDataContainerSettings.Remove-Methode auf, um die exampleSetting Einstellung zu löschen, wenn Sie damit fertig sind.

Beachten Sie, dass sie für den Zugriff auf die RoamingSettings denselben Prozess verwenden, der im Beispiel beschrieben ist, außer die Vorkommen von localSettings in zu ändern. roamingSettings

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

// Create a simple setting.
localSettings.Values["exampleSetting"] = "Hello Windows";

// Read data from a simple setting.
Object value = localSettings.Values["exampleSetting"];

if (value == null)
{
    // No data.
}
else
{
    // Access data in value.
}

// Delete a simple setting.
localSettings.Values.Remove("exampleSetting");

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

// Create a simple setting.
auto values{ localSettings.Values() };
values.Insert(L"exampleSetting", Windows::Foundation::PropertyValue::CreateString(L"Hello Windows"));

// Read data from a simple setting.
winrt::hstring value{ winrt::unbox_value<winrt::hstring>(values.Lookup(L"exampleSetting")) };

// Access data in value.

// Delete a simple setting.
values.Remove(L"exampleSetting");

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.
String^ value = safe_cast<String^>(values->Lookup("exampleSetting"));

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

// Delete a simple setting.
values->Remove("exampleSetting");

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

' Create a simple setting

localSettings.Values("exampleSetting") = "Hello Windows";

' Read data from a simple setting

Dim value As Object = localSettings.Values("exampleSetting")

If value Is Nothing Then
   ' No data
Else
   ' Access data in value
End If

' Delete a simple setting

localSettings.Values.Remove("exampleSetting")

Hinweise

Für LocalSettings und RoamingSettings kann der Name jeder Einstellung maximal 255 Zeichen lang sein. Jede Einstellung kann bis zu 8 KB groß sein, und jede zusammengesetzte Einstellung kann bis zu 64 KB groß sein.

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

Weitere Informationen

• Speichern und Abrufen von Einstellungen und anderen App-Daten
• Inhaltsindexerbeispiel (Windows 10)