ApplicationSettingsBase.SettingsKey Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setPublic Property SettingsKey As StringValeur 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 .
