ApplicationSettingsBase.SettingsKey 屬性

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

套件:

System.Configuration.ConfigurationManager v8.0.0

來源:

ApplicationSettingsBase.cs

取得或設定應用程式設定群組的設定索引鍵。

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

屬性值

String

String，包含目前設定群組的設定索引鍵。

屬性

BrowsableAttribute

備註

提供 SettingsKey 屬性以啟用用戶端程式代碼，特別是設定提供者，以釐清相同應用程式設定類別的多個實例。

除非使用單一模式設計設定包裝函式類別，否則單一應用程式中可以有多個相同應用程式設定類別的實例。 的值 SettingsKey 應該根據屬性值的共用方式來設定。

• 如果包裝函式的設定屬性是要在相同應用程式中包裝函式的所有實例之間共用，則 SettingsKey 在所有實例中都應該有相同的值。 這是類別的預設行為 ApplicationSettingsBase 。

• 如果包裝函式的設定屬性是每個實例的設定屬性，則 SettingsKey 每個實例都應該有唯一的值。 建 ApplicationSettingsBase(String) 構函式的版本可讓您初始化 SettingsKey 為唯一字串。

相反地， Context 屬性會提供提示給設定提供者，讓它以有效率且有順序的方式保存值。

類別 SettingChangingEventArgs 包含類似的 SettingKey 屬性，可協助識別事件的來源 SettingChanging 。

另請參閱

• Context
• SettingChangingEventArgs