應用程式設定屬性
更新：2007 年 11 月
應用程式設定架構提供了許多屬性 (Attribute)，可套用至應用程式設定包裝函式類別 (Wrapper Class) 或其個別屬性 (Property)。應用程式設定基礎結構 (尤其經常是設定提供者) 會在執行階段檢查這些屬性 (Attribute)，將屬性 (Attribute) 的運作修改為符合自訂包裝函式所敍述的需求。
下表列出了可套用至應用程式設定包裝函式類別、該類別之個別屬性 (Property) 或這兩者的屬性 (Attribute)。根據定義，唯有單一範圍屬性 (Attribute)，UserScopedSettingAttribute 或 ApplicationScopedSettingAttribute，才必須一一套用至所有設定屬性 (Property)。
.gif "注意事項") 注意事項： |
|---|
只有在識別 ApplicationScopedSettingAttribute、UserScopedSettingAttribute 和 DefaultSettingValueAttribute 這三個屬性 (Attribute) 的時候才需要衍生自 SettingsProvider 類別的自訂設定提供者。 |
屬性 |
目標 |
描述 |
|---|---|---|
兩者 |
指定保存時所使用的設定提供者之簡短名稱。 如果未提供這個屬性 (Attribute)，則會假設為預設提供者 LocalFileSettingsProvider。 |
|
兩者 |
將屬性 (Property) 定義為使用者範圍的應用程式設定。 |
|
兩者 |
將屬性 (Property) 定義為應用程式範圍的應用程式設定。 |
|
屬性 |
指定字串，此字串可由提供者還原序列化，而直接編寫成這個屬性 (Property) 的預設值。 LocalFileSettingsProvider 並不需要這個屬性 (Attribute)，而且如果已有保存的數值那麼它將覆寫此屬性所提供的任何值。 |
|
屬性 |
提供個別設定的描述性測試，主要供執行階段工具和設計階段工具使用。 |
|
類別 |
提供設定群組的明確名稱。如果找不到這個屬性 (Attribute)，則 ApplicationSettingsBase 使用包裝函式類別名稱。 |
|
類別 |
提供設定群組的描述性測試，主要供執行階段工具和設計階段工具使用。 |
|
兩者 |
指定零或多個管理性服務，此服務應提供給設定群組或設定屬性 (Property)。可用的服務是由 SettingsManageability 列舉型別描述。 |
|
屬性 |
指定設定屬於某一特殊預先定義的分類，例如連接字串 (Connection String)，該分類建議由設定提供者進行特別處理。這個屬性 (Attribute) 的預先定義分類是由 SpecialSetting 列舉型別定義。 |
|
兩者 |
指定設定群組或設定屬性 (Property) 的慣用序列化 (Serialization) 機制。可用的序列化機制是由 SettingsSerializeAs 列舉型別定義。 |
|
屬性 |
指定設定提供者應該停用已標記屬性 (Property) 的所有應用程式升級功能。 |
類別表示該屬性 (Attribute) 只能套用至應用程式設定包裝函式類別。「屬性」(Property) 表示該屬性 (Attribute) 只能套用至設定屬性 (Property)。「兩者」(Both) 表示該屬性 (Attribute) 可以套用至兩者之中任一層級。