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

Definizione

Memorizza i valori correnti delle proprietà delle impostazioni dell'applicazione.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 ()

Esempi

Nell'esempio di codice seguente viene Save illustrato il metodo chiamato Closing dal gestore eventi per il form primario.The following code example shows the Save method being called from the Closing event handler for the primary form. Questo metodo aggiunge anche un periodo aggiuntivo alla proprietà Settings associata alla Text proprietà del form.This method also appends an extra period to the settings property that is associated with the form's Text property.

L'esempio di codice completo è elencato nella ApplicationSettingsBase Panoramica della 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

Commenti

Il Save metodo scrive il valore corrente di ogni proprietà Settings nell'archivio dati associato.The Save method writes the current value of each settings property to its associated data store. Per ogni proprietà, questo metodo chiama il SetPropertyValues metodo sul provider di impostazioni associato.For each property, this method calls the SetPropertyValues method on the associated settings provider.

Questo metodo differisce dall'implementazione della classe di base perché genera l' SettingsSaving evento prima che i valori vengano scritti.This method differs from the base class implementation in that it raises the SettingsSaving event before the values are written.

Se le uniche impostazioni definite sono le impostazioni con ambito di applicazione Save , non avranno alcun effetto e non restituiranno alcun errore se viene LocalFileSettingsProviderchiamato con il valore predefinito.If the only settings defined are application-scoped settings, Save will have no effect and return no error if called with the default LocalFileSettingsProvider. LocalFileSettingsProviderSalva solo le impostazioni con ambito di utente.LocalFileSettingsProvider only saves user-scoped settings.

Importante

Non esiste alcun metodo Load corrispondente perché i valori delle impostazioni dell'applicazione vengono caricati automaticamente durante l'inizializzazione della classe wrapper.There is no corresponding Load method because the values of application settings are automatically loaded during wrapper class initialization. Al contrario, questi valori non vengono salvati automaticamente al termine di un'applicazione.In contrast, these values are not automatically saved when an application ends. Pertanto, è necessario chiamare in modo esplicito il Save metodo per salvare in modo permanente i valori correnti delle impostazioni dell'applicazione.Therefore, you must explicitly call the Save method to persist the current values of the application settings. Questa operazione viene in genere eseguita Closing nel gestore eventi dell'oggetto primario o Formcontenitore.This is typically performed in the Closing event handler of the primary or containing Form.

Si applica a

Vedi anche