ApplicationSettingsBase.SettingsKey Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Einstellungsschlüssel für die Anwendungseinstellungsgruppe ab oder legt ihn fest.
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 StringEigenschaftswert
Ein String, der den Einstellungsschlüssel für die aktuelle Einstellungsgruppe enthält.
- Attribute
Hinweise
Die SettingsKey -Eigenschaft wird bereitgestellt, um Clientcode und insbesondere den Einstellungsanbieter zu ermöglichen, mehrdeutig zwischen mehreren Instanzen derselben Anwendungseinstellungsklasse zu unterscheiden.
Sofern die Einstellungswrapperklasse nicht mit dem Singletonmuster entworfen wurde, können mehrere Instanzen derselben Anwendungseinstellungsklasse in einer einzelnen Anwendung vorhanden sein. Der Wert von SettingsKey sollte entsprechend festgelegt werden, wie die Eigenschaftswerte freigegeben werden sollen.
Wenn die Einstellungseigenschaften des Wrappers für alle Instanzen des Wrappers in derselben Anwendung freigegeben werden sollen, SettingsKey sollte in allen Instanzen den gleichen Wert aufweisen. Dies ist das Standardverhalten der ApplicationSettingsBase -Klasse.
Wenn die Einstellungseigenschaften des Wrappers pro instance festgelegt werden sollen, SettingsKey sollte für jede instance ein eindeutiger Wert vorhanden sein. Mit ApplicationSettingsBase(String) der Version des Konstruktors können Sie eine eindeutige Zeichenfolge initialisieren SettingsKey .
Im Gegensatz dazu stellt die Context -Eigenschaft Dem Einstellungsanbieter Hinweise zur Verfügung, damit werte effizient und ordnungsgemäß beibehalten werden können.
Die SettingChangingEventArgs -Klasse enthält eine ähnliche SettingKey Eigenschaft, mit der die Quelle des SettingChanging Ereignisses identifiziert werden kann.
