ApplicationSettingsBase.Save Méthode

Définition

Stocke les valeurs actuelles des propriétés de paramètres d'application.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 ()

Exemples

L’exemple de code suivant montre Save la méthode appelée à partir Closing du gestionnaire d’événements pour le formulaire principal.The following code example shows the Save method being called from the Closing event handler for the primary form. Cette méthode ajoute également un point supplémentaire à la propriété de paramètres associée à la propriété du Text formulaire.This method also appends an extra period to the settings property that is associated with the form's Text property.

L’exemple de code complet est listé dans ApplicationSettingsBase la vue d’ensemble de la classe.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

Remarques

La Save méthode écrit la valeur actuelle de chaque propriété de paramètres dans son magasin de données associé.The Save method writes the current value of each settings property to its associated data store. Pour chaque propriété, cette méthode appelle la SetPropertyValues méthode sur le fournisseur de paramètres associé.For each property, this method calls the SetPropertyValues method on the associated settings provider.

Cette méthode diffère de l’implémentation de la classe de base dans le SettingsSaving cas où elle déclenche l’événement avant l’écriture des valeurs.This method differs from the base class implementation in that it raises the SettingsSaving event before the values are written.

Si les seuls paramètres définis sont des paramètres de portée application, Save n’aura aucun effet et ne retournera aucune erreur si elle LocalFileSettingsProviderest appelée avec la valeur par défaut.If the only settings defined are application-scoped settings, Save will have no effect and return no error if called with the default LocalFileSettingsProvider. LocalFileSettingsProviderenregistre uniquement les paramètres de portée utilisateur.LocalFileSettingsProvider only saves user-scoped settings.

Important

Il n’existe pas de méthode Load correspondante, car les valeurs des paramètres d’application sont chargées automatiquement pendant l’initialisation de la classe wrapper.There is no corresponding Load method because the values of application settings are automatically loaded during wrapper class initialization. En revanche, ces valeurs ne sont pas automatiquement enregistrées lorsqu’une application se termine.In contrast, these values are not automatically saved when an application ends. Par conséquent, vous devez appeler explicitement Save la méthode pour rendre persistantes les valeurs actuelles des paramètres de l’application.Therefore, you must explicitly call the Save method to persist the current values of the application settings. En général, cette opération est Closing effectuée dans le gestionnaire d’événements du Formprimaire ou du conteneur.This is typically performed in the Closing event handler of the primary or containing Form.

S’applique à

Voir aussi