ApplicationSettingsBase.Save メソッド


アプリケーション設定プロパティの現在の値を格納します。Stores the current values of the application settings properties.

 override void Save();
public override void Save ();
override this.Save : unit -> unit
Public Overrides Sub Save ()

次のコード例は、 SaveプライマリフォームのClosingイベントハンドラーから呼び出されるメソッドを示しています。The following code example shows the Save method being called from the Closing event handler for the primary form. また、このメソッドは、フォームのTextプロパティに関連付けられた設定プロパティに追加の期間を追加します。This method also appends an extra period to the settings property that is associated with the form's Text property.

完全なコード例についてはApplicationSettingsBase 、クラスの概要に記載されています。The full code example is listed in the ApplicationSettingsBase class overview.

    void AppSettingsForm_FormClosing(Object^ sender,
        FormClosingEventArgs^ e)
        //Synchronize manual associations first.
        formSettings->FormText = this->Text + '.';
private void Form1_FormClosing(object sender, FormClosingEventArgs e)
    //Synchronize manual associations first.
    frmSettings1.FormText = this.Text + '.';
    frmSettings1.FormSize = this.Size;
Private Sub Form1_FormClosing_1(ByVal sender As Object, ByVal e As _
        FormClosingEventArgs) Handles MyBase.FormClosing
    'Synchronize manual associations first.
    frmSettings1.FormText = Me.Text + "."c

    ' Save size settings manually.
    frmSettings1.FormSize = Me.Size

End Sub


メソッドSaveは、各設定プロパティの現在の値を、関連付けられているデータストアに書き込みます。The Save method writes the current value of each settings property to its associated data store. このメソッドは、プロパティごとに、 SetPropertyValues関連付けられた設定プロバイダーのメソッドを呼び出します。For each property, this method calls the SetPropertyValues method on the associated settings provider.

このメソッドは、値が書き込まれる前にイベントをSettingsSaving発生させるという点で、基本クラスの実装とは異なります。This method differs from the base class implementation in that it raises the SettingsSaving event before the values are written.

定義されている設定がアプリケーションスコープ設定のみSaveの場合、は無効になり、既定LocalFileSettingsProviderのを使用して呼び出された場合はエラーを返しません。If the only settings defined are application-scoped settings, Save will have no effect and return no error if called with the default LocalFileSettingsProvider. LocalFileSettingsProviderユーザースコープの設定のみを保存します。LocalFileSettingsProvider only saves user-scoped settings.


ラッパークラスの初期化中にアプリケーション設定の値が自動的に読み込まれるため、対応する Load メソッドはありません。There is no corresponding Load method because the values of application settings are automatically loaded during wrapper class initialization. これに対し、これらの値は、アプリケーションの終了時に自動的には保存されません。In contrast, these values are not automatically saved when an application ends. そのため、アプリケーション設定の現在Saveの値を永続化するには、メソッドを明示的に呼び出す必要があります。Therefore, you must explicitly call the Save method to persist the current values of the application settings. これは、通常、プライマリClosingまたはを含むFormのイベントハンドラーで実行されます。This is typically performed in the Closing event handler of the primary or containing Form.