次の方法で共有


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から派生した settings ラッパー クラスには、すべての設定プロパティの値を保持するために呼び出されるSave メソッドが含まれています。 このメソッドは、設定プロパティに関連付けられているすべての設定プロバイダーを列挙し、各SettingsProviderSetPropertyValues メソッドを呼び出して、実際のシリアル化操作を実行します。

SetPropertyValues は、ユーザー スコープの各アプリケーション設定プロパティを、適切な user.config 構成ファイル内の対応するアプリケーション設定に個別にシリアル化します。

既定では、 SetPropertyValues メソッドは、設定プロパティの種類に応じて、次の論理シーケンスを使用してシリアル化スキームを決定します。

  1. 型にConvertToStringメソッドの実装に関連付けられたTypeConverterがある場合、この変換が使用されます。

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

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

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

注意事項

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

適用対象

こちらもご覧ください