ApplicationSettingsBase.SettingsKey Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta la chiave delle impostazioni per il gruppo di impostazioni dell'applicazione.
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 StringValore della proprietà
Classe String contenente la chiave delle impostazioni per il gruppo di impostazioni corrente.
- Attributi
Commenti
La SettingsKey proprietà viene fornita per abilitare il codice client, in particolare il provider di impostazioni, per evitare ambiguità tra più istanze della stessa classe di impostazioni dell'applicazione.
A meno che la classe wrapper delle impostazioni non sia progettata usando il modello singleton, in una singola applicazione possono essere presenti più istanze della stessa classe di impostazioni dell'applicazione. Il valore di SettingsKey deve essere impostato in base alla modalità di condivisione dei valori delle proprietà.
Se le proprietà delle impostazioni del wrapper devono essere condivise in tutte le istanze del wrapper nella stessa applicazione, SettingsKey deve avere lo stesso valore in tutte le istanze. Si tratta del comportamento predefinito della ApplicationSettingsBase classe .
Se le proprietà delle impostazioni del wrapper devono essere per ogni istanza, SettingsKey deve avere un valore univoco per ogni istanza. La ApplicationSettingsBase(String) versione del costruttore consente di inizializzare SettingsKey in una stringa univoca.
Al contrario, la Context proprietà fornisce suggerimenti al provider di impostazioni per consentirlo di rendere persistenti i valori in modo efficiente e ordinato.
La SettingChangingEventArgs classe contiene una proprietà simile SettingKey che consente di identificare l'origine dell'evento SettingChanging .
