ApplicationSettingsBase.Save Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.