Exporter (0) Imprimer
Développer tout

ApplicationSettingsBase.SettingsKey, propriété

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

Espace de noms: System.Configuration
Assembly : System (dans system.dll)

public string SettingsKey { get; set; }
/** @property */
public String get_SettingsKey ()

/** @property */
public void set_SettingsKey (String value)

public function get SettingsKey () : String

public function set SettingsKey (value : String)

Non applicable.

Valeur de la propriété

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

La propriété SettingsKey est fournie afin de 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.

À moins que la classe wrapper de paramètres soit conçue à l'aide du motif singleton, il peut exister plusieurs instances de la même classe de paramètres d'application dans une même application. La valeur de SettingsKey doit être définie selon la manière dont vous souhaitez partager les valeurs de propriétés.

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

  • Si les propriétés de paramètres du wrapper sont destinées à être spécifiques à chaque instance, SettingsKey doit avoir une valeur unique pour chaque instance. La version ApplicationSettingsBase(String) du constructeur vous permet d'initialiser SettingsKey à une chaîne unique.

Par contraste, la propriété Context procure des indications relatives au fournisseur de paramètres afin de lui permettre de rendre les valeurs persistantes d'une manière efficace et ordonnée.

La classe SettingChangingEventArgs contient une propriété SettingKey semblable qui aide à identifier la source de l'événement SettingChanging.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft