ApplicationSettingsBase.Save Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic 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.
