ApplicationSettingsBase.Save Método

Definición

Espacio de nombres:

System.Configuration

Ensamblado:

System.Configuration.ConfigurationManager.dll

Paquete:

System.Configuration.ConfigurationManager v8.0.0

Source:

ApplicationSettingsBase.cs

Almacena los valores actuales de las propiedades de configuración de la aplicación.

public:
 override void Save();

public override void Save ();

override this.Save : unit -> unit

Public Overrides Sub Save ()

Ejemplos

En el ejemplo de código siguiente se muestra el Save método al que se llama desde el Closing controlador de eventos para el formulario principal. Este método también anexa un punto adicional a la propiedad settings que está asociada a la propiedad del Text formulario.

El ejemplo de código completo se muestra en la información general de la ApplicationSettingsBase clase.

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

Comentarios

El Save método escribe el valor actual de cada propiedad de configuración en su almacén de datos asociado. Para cada propiedad, este método llama al SetPropertyValues método en el proveedor de configuración asociado.

Este método difiere de la implementación de la clase base en que genera el SettingsSaving evento antes de que se escriban los valores.

Si la única configuración definida es la configuración con ámbito de aplicación, Save no tendrá ningún efecto y no devolverá ningún error si se llama con el valor predeterminado LocalFileSettingsProvider. LocalFileSettingsProvider solo guarda la configuración con ámbito de usuario.

Importante

No hay ningún método Load correspondiente porque los valores de la configuración de la aplicación se cargan automáticamente durante la inicialización de la clase contenedora. Por el contrario, estos valores no se guardan automáticamente cuando finaliza una aplicación. Por lo tanto, debe llamar explícitamente al Save método para conservar los valores actuales de la configuración de la aplicación. Normalmente, esto se realiza en el Closing controlador de eventos del principal o que contiene Form.

Consulte también

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