Partage via


ApplicationSettingsBase.SettingsKey Propriété

Définition

Obtient ou définit la clé de paramètres pour le groupe de paramètres d'application.

public:
 property System::String ^ SettingsKey { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
public string SettingsKey { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.SettingsKey : string with get, set
Public Property SettingsKey As String

Valeur de propriété

String contenant la clé de paramètres pour le groupe de paramètres actuel.

Attributs

Remarques

La SettingsKey propriété est fournie pour permettre au code client, et en particulier au fournisseur de paramètres, de lever l’ambiguïté entre plusieurs instances de la même classe de paramètres d’application.

Sauf si la classe wrapper de paramètres est conçue à l’aide du modèle singleton, il peut y avoir plusieurs instances de la même classe de paramètres d’application dans une seule application. La valeur de SettingsKey doit être définie en fonction de la façon dont les valeurs de propriété sont destinées à être partagées.

  • Si les propriétés de paramètres du wrapper sont destinées à être partagées entre toutes les instances du wrapper dans la même application, elles SettingsKey doivent avoir la même valeur dans toutes les instances. Il s’agit du comportement par défaut de la ApplicationSettingsBase classe.

  • Si les propriétés de paramètres du wrapper sont conçues pour être par instance, elles SettingsKey doivent avoir une valeur unique pour chaque instance. La ApplicationSettingsBase(String) version du constructeur vous permet d’initialiser SettingsKey dans une chaîne unique.

En revanche, la Context propriété fournit des conseils au fournisseur de paramètres pour lui permettre de conserver les valeurs de manière efficace et ordonnée.

La SettingChangingEventArgs classe contient une propriété similaire SettingKey qui permet d’identifier la source de l’événement SettingChanging .

S’applique à

Voir aussi