ApplicationSettingsBase.SettingsKey Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de instellingensleutel voor de groep toepassingsinstellingen op of stelt u deze in.
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 StringWaarde van eigenschap
Een String met de instellingensleutel voor de huidige instellingengroep.
- Kenmerken
Opmerkingen
De SettingsKey eigenschap wordt verstrekt om clientcode, en met name de instellingenprovider, in te schakelen tussen meerdere exemplaren van dezelfde klasse toepassingsinstellingen.
Tenzij de wrapper-klasse instellingen is ontworpen met behulp van het singleton-patroon, kunnen er meerdere exemplaren van dezelfde klasse toepassingsinstellingen in één toepassing zijn. De waarde van SettingsKey moet worden ingesteld op basis van de wijze waarop de eigenschapswaarden moeten worden gedeeld.
Als de instellingeneigenschappen van de wrapper zijn bedoeld om te worden gedeeld over alle exemplaren van de wrapper in dezelfde toepassing, SettingsKey moet deze dezelfde waarde hebben in alle exemplaren. Dit is het standaardgedrag van de ApplicationSettingsBase klasse.
Als de instellingeneigenschappen van de wrapper per exemplaar zijn bedoeld, SettingsKey moet deze een unieke waarde hebben voor elk exemplaar. Met ApplicationSettingsBase(String) de versie van de constructor kunt u een unieke tekenreeks initialiseren SettingsKey .
De eigenschap biedt daarentegen Context hints aan de instellingenprovider om deze in staat te stellen waarden op een efficiënte en ordelijke manier te behouden.
De SettingChangingEventArgs klasse bevat een vergelijkbare SettingKey eigenschap waarmee de bron van de SettingChanging gebeurtenis kan worden geïdentificeerd.