LocalFileSettingsProvider.SetPropertyValues メソッド

  • リファレンス

定義

名前空間:
System.Configuration
アセンブリ:
System.Configuration.ConfigurationManager.dll
アセンブリ:
System.dll
パッケージ:
System.Configuration.ConfigurationManager v8.0.1
パッケージ:
System.Configuration.ConfigurationManager v9.0.0-rc.2.24473.5
ソース:
LocalFileSettingsProvider.cs
ソース:
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. 型に メソッドの実装に関連付けられている TypeConverter がある ConvertToString 場合は、この変換が使用されます。

  2. XML シリアル化が使用されます。

ただし、 を使用して、推奨されるシリアル化メカニズムを SettingsSerializeAsAttribute指定できます。 LocalFileSettingsProvider では、Visual Studio 2005 でのバイナリ シリアル化はサポートされていません。

ユーザー スコープ設定プロパティが既定値に明示的に設定されている場合、ローカル ファイル設定プロバイダーは、関連付けられている設定のエントリをユーザー構成ファイルから削除します。 このプロパティの次の読み取りアクセスでは、単に既定値が使用されます。

注意事項

LocalFileSettingsProvider では、暗号化を使用して設定を保持しません。 そのため、構成ファイル内の情報を個別に暗号化するなど、追加の予防措置を講じることなく、このプロバイダーを使用してプレーンテキスト パスワードやその他の機密情報を格納しないでください。 詳細については、「 保護された構成を使用した構成情報の暗号化」を参照してください。

適用対象

こちらもご覧ください