ApplicationSettingsBase.Save ApplicationSettingsBase.Save ApplicationSettingsBase.Save ApplicationSettingsBase.Save Method

Определение

Сохраняет текущие значения свойств параметров приложения.Stores the current values of the application settings properties.

public:
 override void Save();
public override void Save ();
override this.Save : unit -> unit
Public Overrides Sub Save ()

Примеры

В следующем примере кода показан Save метод, вызываемый Closing из обработчика событий для основной формы.The following code example shows the Save method being called from the Closing event handler for the primary form. Этот метод также добавляет дополнительный период к свойству Settings, связанному со Text свойством формы.This method also appends an extra period to the settings property that is associated with the form's Text property.

Полный пример кода приведен в ApplicationSettingsBase обзоре класса.The full code example is listed in the ApplicationSettingsBase class overview.

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 Метод записывает текущее значение каждого свойства параметров в связанное хранилище данных.The Save method writes the current value of each settings property to its associated data store. Для каждого свойства этот метод вызывает SetPropertyValues метод для соответствующего поставщика параметров.For each property, this method calls the SetPropertyValues method on the associated settings provider.

Этот метод отличается от реализации базового класса тем, что он вызывает SettingsSaving событие перед записью значений.This method differs from the base class implementation in that it raises the SettingsSaving event before the values are written.

Если только определенные параметры задаются в параметрах области приложения Save , они не будут действовать и возвращают ошибку, если она вызвана с параметром по умолчанию. LocalFileSettingsProviderIf the only settings defined are application-scoped settings, Save will have no effect and return no error if called with the default LocalFileSettingsProvider. LocalFileSettingsProviderсохраняются только параметры области пользователя.LocalFileSettingsProvider only saves user-scoped settings.

Важно!

Нет соответствующего метода Load, так как значения параметров приложения автоматически загружаются во время инициализации класса-оболочки.There is no corresponding Load method because the values of application settings are automatically loaded during wrapper class initialization. Напротив, эти значения не сохраняются автоматически при завершении приложения.In contrast, these values are not automatically saved when an application ends. Поэтому необходимо явно вызвать Save метод, чтобы сохранить текущие значения параметров приложения.Therefore, you must explicitly call the Save method to persist the current values of the application settings. Обычно это выполняется в Closing обработчике событий первичного или содержащего. FormThis is typically performed in the Closing event handler of the primary or containing Form.

Применяется к

Дополнительно