ApplicationSettingsBase.SettingsKey Proprietà

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

ApplicationSettingsBase.cs

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à

String

Classe String contenente la chiave delle impostazioni per il gruppo di impostazioni corrente.

Attributi

BrowsableAttribute

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 .

Vedi anche

• Context
• SettingChangingEventArgs