ApplicationData.LocalSettings Propriété

Définition

Espace de noms:

Windows.Storage

Obtient le conteneur de paramètres d’application dans le magasin de données d’application local.

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

ApplicationDataContainer LocalSettings();

public ApplicationDataContainer LocalSettings { get; }

var applicationDataContainer = applicationData.localSettings;

Public ReadOnly Property LocalSettings As ApplicationDataContainer

Valeur de propriété

ApplicationDataContainer

Conteneur des paramètres de l’application.

Exemples

Utilisez la propriété LocalSettings pour obtenir les paramètres d’un objet ApplicationDataContainer . Utilisez la propriété ApplicationDataContainer.Values pour accéder aux paramètres du localSettings conteneur. Cet exemple crée et lit un paramètre nommé exampleSetting.

Appelez la méthode ApplicationDataContainerSettings.Remove pour supprimer le exampleSetting paramètre lorsque vous en avez terminé.

Notez que pour accéder à RoamingSettings, utilisez le même processus décrit dans l’exemple, à l’exception de modifier les occurrences de localSettings par 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")

Remarques

Pour LocalSettings et RoamingSettings, le nom de chaque paramètre peut être de 255 caractères maximum. La taille de chaque paramètre peut atteindre 8 000 octets et chaque paramètre composite peut atteindre 64 000 octets.

Les types de données Windows Runtime sont pris en charge pour les paramètres d’application.

Voir aussi

• Stocker et récupérer des paramètres et autres données d’application
• Exemple d’indexeur de contenu (Windows 10)