ApplicationSettingsBase.Save Метод

Определение

Пространство имен:

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

System.Configuration.ConfigurationManager v8.0.0

Исходный код:

ApplicationSettingsBase.cs

Сохраняет текущие значения свойств параметров приложения.

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.

См. также раздел

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