ApplicationSettingsBase.Save Méthode

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

ApplicationSettingsBase.cs

Stocke les valeurs actuelles des propriétés de paramètres d'application.

public:
 override void Save();

public override void Save ();

override this.Save : unit -> unit

Public Overrides Sub Save ()

Exemples

L’exemple de code suivant montre la Save méthode appelée à partir du Closing gestionnaire d’événements pour le formulaire principal. Cette méthode ajoute également un point supplémentaire à la propriété settings associée à la propriété du Text formulaire.

L’exemple de code complet est répertorié dans la vue d’ensemble de la ApplicationSettingsBase classe.

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

Remarques

La Save méthode écrit la valeur actuelle de chaque propriété de paramètres dans son magasin de données associé. Pour chaque propriété, cette méthode appelle la SetPropertyValues méthode sur le fournisseur de paramètres associé.

Cette méthode diffère de l’implémentation de la classe de base en ce qu’elle déclenche l’événement SettingsSaving avant l’écriture des valeurs.

Si les seuls paramètres définis sont des paramètres d’étendue d’application, Save n’aura aucun effet et ne retourne aucune erreur s’il est appelé avec la valeur par défaut LocalFileSettingsProvider. LocalFileSettingsProvider enregistre uniquement les paramètres définis par l’utilisateur.

Important

Il n’existe aucune méthode Load correspondante, car les valeurs des paramètres d’application sont automatiquement chargées lors de l’initialisation de la classe wrapper. En revanche, ces valeurs ne sont pas enregistrées automatiquement à la fin d’une application. Par conséquent, vous devez appeler explicitement la Save méthode pour conserver les valeurs actuelles des paramètres de l’application. Cette opération est généralement effectuée dans le Closing gestionnaire d’événements du principal ou contenant Form.

Voir aussi

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