Condividi tramite


ApplicationSettingsBase.SettingsKey Proprietà

Definizione

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

Valore 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 .

Si applica a

Vedi anche