LocalFileSettingsProvider.SetPropertyValues 方法

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

套件:

System.Configuration.ConfigurationManager v8.0.0

來源:

LocalFileSettingsProvider.cs

設定指定屬性設定群組的值。

public:
 override void SetPropertyValues(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyValueCollection ^ values);

public override void SetPropertyValues (System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyValueCollection values);

override this.SetPropertyValues : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyValueCollection -> unit

Public Overrides Sub SetPropertyValues (context As SettingsContext, values As SettingsPropertyValueCollection)

參數

context

SettingsContext

SettingsContext，描述目前應用程式的使用方式。

values

SettingsPropertyValueCollection

SettingsPropertyValueCollection，表示要設定的屬性設定群組。

例外狀況

ConfigurationErrorsException

遇到了使用者範圍的設定，但是目前的組態僅支援應用程式範圍的設定。

-或-

將設定儲存至組態檔時發生一般錯誤。

備註

衍生自 ApplicationSettingsBase的設定包裝函式類別包含 Save 方法，這個方法會呼叫以保存其所有設定屬性的值。 這個方法會列舉與其設定屬性相關聯的所有設定提供者，並針對每個SettingsProvider提供者呼叫 SetPropertyValues 方法來執行實際的串行化作業。

SetPropertyValues 個別串行化每個使用者範圍的應用程式設定屬性，使其在適當的 user.config 組態檔中對應的應用程式設定。

根據預設，方法 SetPropertyValues 會根據 settings 屬性的類型，使用下列邏輯序列來判斷串行化配置：

1. 如果類型具有與方法實作ConvertToString相關聯的 TypeConverter ，則會使用此轉換。

2. 使用 XML 串行化。

不過，您可以使用 來指定慣用 SettingsSerializeAsAttribute的串行化機制。 LocalFileSettingsProvider 不支援 Visual Studio 2005 中的二進位串行化。

如果用戶範圍設定屬性明確設定回其預設值，則本機檔案設定提供者會從使用者組態檔中移除相關聯設定的專案。 此屬性的下一個讀取許可權只會使用預設值。

警告

LocalFileSettingsProvider 不會使用加密來保存任何設定。 因此，請勿使用此提供者儲存純文本密碼或其他敏感性資訊，而不採取其他預防措施，例如個別加密組態檔中的資訊。 如需詳細資訊，請參閱 使用受保護的組態加密組態資訊。

另請參閱

• GetPropertyValues(SettingsContext, SettingsPropertyCollection)
• Save()
• TypeConverter
• SettingsSerializeAsAttribute