ApplicationSettingsBase.SettingsKey Vlastnost

Definice

Získá nebo nastaví klíč nastavení pro skupinu nastavení aplikace.

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

Hodnota vlastnosti

Obsahující String klíč nastavení pro aktuální skupinu nastavení.

Atributy

Poznámky

Vlastnost je poskytována SettingsKey k povolení klientského kódu, a zejména zprostředkovatele nastavení, k nejednoznačnosti mezi více instancemi stejné třídy nastavení aplikace.

Pokud není třída obálky nastavení navržena pomocí jednoznačného vzoru, může v jedné aplikaci existovat více instancí stejné třídy nastavení aplikace. Hodnota SettingsKey by měla být nastavena podle toho, jak se mají hodnoty vlastností sdílet.

  • Pokud mají být vlastnosti nastavení obálky sdíleny napříč všemi instancemi obálky ve stejné aplikaci, SettingsKey pak by měly mít ve všech instancích stejnou hodnotu. Toto je výchozí chování ApplicationSettingsBase třídy .

  • Pokud jsou vlastnosti nastavení obálky určeny pro jednotlivé instance, SettingsKey pak by měla mít jedinečnou hodnotu pro každou instanci. Verze ApplicationSettingsBase(String) konstruktoru umožňuje inicializovat SettingsKey jedinečný řetězec.

Naproti tomu vlastnost poskytuje zprostředkovateli nastavení rady, Context které mu umožňují efektivně a spořádaně uchovávat hodnoty.

Třída SettingChangingEventArgs obsahuje podobnou SettingKey vlastnost, která pomáhá identifikovat zdroj SettingChanging události.

Platí pro

Viz také