LocalFileSettingsProvider.SetPropertyValues メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したプロパティ設定グループの値を設定します。
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 。
設定するプロパティ設定のグループを表す SettingsPropertyValueCollection 。
例外
ユーザー スコープの設定が見つかりましたが、現在の構成ではアプリケーション スコープの設定のみがサポートされています。
-又は-
設定を構成ファイルに保存する一般的なエラーが発生しました。
注釈
ApplicationSettingsBaseから派生した settings ラッパー クラスには、すべての設定プロパティの値を保持するために呼び出されるSave メソッドが含まれています。 このメソッドは、設定プロパティに関連付けられているすべての設定プロバイダーを列挙し、各SettingsProviderのSetPropertyValues メソッドを呼び出して、実際のシリアル化操作を実行します。
SetPropertyValues は、ユーザー スコープの各アプリケーション設定プロパティを、適切な user.config 構成ファイル内の対応するアプリケーション設定に個別にシリアル化します。
既定では、 SetPropertyValues メソッドは、設定プロパティの種類に応じて、次の論理シーケンスを使用してシリアル化スキームを決定します。
型にConvertToStringメソッドの実装に関連付けられたTypeConverterがある場合、この変換が使用されます。
XML シリアル化が使用されます。
ただし、 SettingsSerializeAsAttributeを使用して、推奨されるシリアル化メカニズムを指定できます。 LocalFileSettingsProvider では、Visual Studio 2005 でのバイナリ シリアル化はサポートされていません。
ユーザー スコープの設定プロパティが既定値に明示的に設定されている場合、ローカル ファイル設定プロバイダーは、関連付けられている設定のエントリをユーザー構成ファイルから削除します。 このプロパティの次の読み取りアクセスでは、既定値が使用されます。
注意事項
LocalFileSettingsProvider は、暗号化を使用して設定を保持しません。 そのため、構成ファイル内の情報を個別に暗号化するなど、追加の予防措置を講じることなく、このプロバイダーを使用してプレーン テキスト パスワードやその他の機密情報を格納しないでください。