共用方式為


LocalFileSettingsProvider.SetPropertyValues 方法

定義

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

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,表示要設定的屬性設定群組。

例外狀況

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

-或-

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

備註

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

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

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

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

  2. 會使用 XML 串行化。

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

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

警告

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

適用於

另請參閱