ApplicationSettingsBase.SettingsKey Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
A String obsahující klíč nastavení pro aktuální skupinu nastavení.
- Atributy
Poznámky
Tato vlastnost je poskytována SettingsKey pro povolení klientského kódu a zejména zprostředkovatele nastavení, aby se nejednoznačný mezi více instancemi stejné třídy nastavení aplikace.
Pokud není obálka nastavení navržena pomocí jednotonového vzoru, může existovat více instancí stejné třídy nastavení aplikace v jedné aplikaci. Hodnota SettingsKey by měla být nastavena podle toho, jak mají být hodnoty vlastností sdíleny.
Pokud mají být vlastnosti nastavení obálky sdíleny napříč všemi instancemi obálky ve stejné aplikaci, SettingsKey měly by 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čené pro každou instanci, SettingsKey měly by mít jedinečnou hodnotu pro každou instanci. Verze ApplicationSettingsBase(String) konstruktoru umožňuje inicializovat SettingsKey na jedinečný řetězec.
Naproti tomu vlastnost poskytuje zprostředkovateli nastavení nápovědy, Context které mu umožní zachovat hodnoty efektivním a uspořádaným způsobem.
Třída SettingChangingEventArgs obsahuje podobnou SettingKey vlastnost, která pomáhá identifikovat zdroj SettingChanging události.