ApplicationSettingsBase.Save メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アプリケーション設定プロパティの現在の値を格納します。
public:
override void Save();public override void Save();override this.Save : unit -> unitPublic Overrides Sub Save ()例
次のコード例は、プライマリ フォームのClosing イベント ハンドラーから呼び出されるSave メソッドを示しています。 また、このメソッドは、フォームの Text プロパティに関連付けられている settings プロパティに余分な期間を追加します。
完全なコード例は、 ApplicationSettingsBase クラスの概要に記載されています。
private:
void AppSettingsForm_FormClosing(Object^ sender,
FormClosingEventArgs^ e)
{
//Synchronize manual associations first.
formSettings->FormText = this->Text + '.';
formSettings->Save();
}
private void Form1_FormClosing(object sender, FormClosingEventArgs e)
{
//Synchronize manual associations first.
frmSettings1.FormText = this.Text + '.';
frmSettings1.FormSize = this.Size;
frmSettings1.Save();
}
Private Sub Form1_FormClosing_1(ByVal sender As Object, ByVal e As _
FormClosingEventArgs) Handles MyBase.FormClosing
'Synchronize manual associations first.
frmSettings1.FormText = Text + "."c
' Save size settings manually.
frmSettings1.FormSize = Size
frmSettings1.Save()
End Sub
注釈
Save メソッドは、各設定プロパティの現在の値を関連付けられたデータ ストアに書き込みます。 プロパティごとに、このメソッドは関連付けられている設定プロバイダーで SetPropertyValues メソッドを呼び出します。
このメソッドは、値が書き込まれる前に SettingsSaving イベントを発生させるという点で、基底クラスの実装とは異なります。
定義されている設定がアプリケーション スコープの設定のみである場合、 Save は影響を受けず、既定の LocalFileSettingsProviderで呼び出された場合はエラーを返しません。 LocalFileSettingsProvider は、ユーザー スコープの設定のみを保存します。
Important
ラッパー クラスの初期化中にアプリケーション設定の値が自動的に読み込まれるため、対応する Load メソッドはありません。 これに対し、これらの値は、アプリケーションの終了時に自動的に保存されません。 そのため、アプリケーション設定の現在の値を保持するには、 Save メソッドを明示的に呼び出す必要があります。 これは通常、プライマリの Closing イベント ハンドラー、または Formを含むイベント ハンドラーで実行されます。
