ApplicationSettingsBase.Save Metodo

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

ApplicationSettingsBase.cs

Memorizza i valori correnti delle proprietà delle impostazioni dell'applicazione.

public:
 override void Save();

public override void Save ();

override this.Save : unit -> unit

Public Overrides Sub Save ()

Esempio

Nell'esempio di codice seguente viene illustrato il Save metodo chiamato dal Closing gestore eventi per il modulo primario. Questo metodo aggiunge anche un periodo aggiuntivo alla proprietà settings associata alla proprietà del Text modulo.

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

Commenti

Il Save metodo scrive il valore corrente di ogni proprietà settings nell'archivio dati associato. Per ogni proprietà, questo metodo chiama il SetPropertyValues metodo nel provider di impostazioni associato.

Questo metodo è diverso dall'implementazione della classe di base in quanto genera l'evento SettingsSaving prima della scrittura dei valori.

Se le uniche impostazioni definite sono impostazioni con ambito applicazione, Save non avrà alcun effetto e non restituirà alcun errore se viene chiamato con l'impostazione predefinita LocalFileSettingsProvider. LocalFileSettingsProvider salva solo le impostazioni con ambito utente.

Importante

Non esiste alcun metodo Load corrispondente perché i valori delle impostazioni dell'applicazione vengono caricati automaticamente durante l'inizializzazione della classe wrapper. Al termine di un'applicazione, questi valori non vengono salvati automaticamente. Pertanto, è necessario chiamare in modo esplicito il Save metodo per rendere persistenti i valori correnti delle impostazioni dell'applicazione. Questa operazione viene in genere eseguita nel Closing gestore eventi del database primario o contenente Form.

Vedi anche

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