通过


ApplicationSettingsBase.Save 方法

定义

存储应用程序设置属性的当前值。

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

示例

下面的代码示例演示 Save 从主窗体的 Closing 事件处理程序中调用的方法。 此方法还会将额外的句点追加到与窗体 Text 属性关联的设置属性。

类概述中 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 仅保存用户范围的设置。

重要

没有相应的 Load 方法,因为在包装器类初始化期间会自动加载应用程序设置的值。 相比之下,应用程序结束时不会自动保存这些值。 因此,必须显式调用 Save 该方法来保留应用程序设置的当前值。 这通常在主要或包含Form的事件处理程序中Closing执行。

适用于

另请参阅