ApplicationSettingsBase.Save 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
存储应用程序设置属性的当前值。
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执行。