Freigeben über


ApplicationSettingsBase.SettingsKey Eigenschaft

Definition

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, set
Public Property SettingsKey As String

Eigenschaftswert

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.

Gilt für:

Weitere Informationen