ApplicationSettingsBase.Save Метод

Определение

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

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

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

ApplicationSettingsBase.cs

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

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 метод для сохранения текущих значений параметров приложения. Обычно это выполняется в Closing обработчике событий первичного или содержащего Form.

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

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