ApplicationSettingsBase.Save 方法

定义

命名空间:

System.Configuration

程序集:

System.Configuration.ConfigurationManager.dll

包:

System.Configuration.ConfigurationManager v8.0.0

Source:

ApplicationSettingsBase.cs

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

public:
 override void Save();

public override void Save ();

override this.Save : unit -> unit

Public Overrides Sub Save ()

示例

下面的代码示例演示 Save 从主窗体的 Closing 事件处理程序调用的方法。 此方法还会向与窗体 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 = Me.Text + "."c

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

    frmSettings1.Save()
End Sub

注解

方法 Save 将每个设置属性的当前值写入其关联的数据存储。 对于每个属性，此方法对关联的设置提供程序调用 SetPropertyValues 方法。

此方法不同于基类实现，因为它在 SettingsSaving 写入值之前引发 事件。

如果定义的唯一设置是应用程序范围的设置，则 如果使用默认 LocalFileSettingsProvider的 调用，Save则 将不起作用且不返回错误。 LocalFileSettingsProvider 仅保存用户范围的设置。

重要

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

另请参阅

• Reset()
• Reload()
• SettingsSaving
• SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)
• SettingsProviderAttribute