ApplicationSettingsBase.Save Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сохраняет текущие значения свойств параметров приложения.
public:
override void Save();
public override void Save ();
override this.Save : unit -> unit
Public Overrides Sub Save ()
Примеры
В следующем примере кода показан метод, Save вызываемый из обработчика Closing событий для первичной формы. Этот метод также добавляет дополнительную точку к свойству settings, связанному со свойством 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 = Me.Text + "."c
' Save size settings manually.
frmSettings1.FormSize = Me.Size
frmSettings1.Save()
End Sub
Комментарии
Метод Save записывает текущее значение каждого свойства параметров в связанное с ним хранилище данных. Для каждого свойства этот метод вызывает SetPropertyValues метод в связанном поставщике параметров.
Этот метод отличается от реализации базового класса тем, что вызывает SettingsSaving событие перед записью значений.
Если определены только параметры области приложения, Save не будет иметь никакого эффекта и не возвращает ошибку при вызове с параметром по умолчанию LocalFileSettingsProvider. LocalFileSettingsProvider Сохраняет только параметры, заданные пользователем.
Важно!
Соответствующий метод Load отсутствует, так как значения параметров приложения автоматически загружаются во время инициализации класса-оболочки. В отличие от этого, эти значения не сохраняются автоматически при завершении работы приложения. Поэтому необходимо явно вызвать метод , Save чтобы сохранить текущие значения параметров приложения. Обычно это выполняется в обработчике Closing событий основного или содержащего Form.