ApplicationSettingsBase.Save Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Speichert die aktuellen Werte der Eigenschaften der Anwendungseinstellungen.
public:
override void Save();public override void Save();override this.Save : unit -> unitPublic Overrides Sub Save ()Beispiele
Das folgende Codebeispiel zeigt die Methode, die Save vom Closing Ereignishandler für das primäre Formular aufgerufen wird. Diese Methode fügt auch einen zusätzlichen Zeitraum an die Einstellungseigenschaft an, die der Eigenschaft des Formulars Text zugeordnet ist.
Das vollständige Codebeispiel wird in der ApplicationSettingsBase Klassenübersicht aufgeführt.
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 = Text + "."c
' Save size settings manually.
frmSettings1.FormSize = Size
frmSettings1.Save()
End Sub
Hinweise
Die Save Methode schreibt den aktuellen Wert jeder Einstellungseigenschaft in den zugehörigen Datenspeicher. Für jede Eigenschaft ruft diese Methode die SetPropertyValues Methode für den zugehörigen Einstellungsanbieter auf.
Diese Methode unterscheidet sich von der Basisklassenimplementierung darin, dass das SettingsSaving Ereignis ausgelöst wird, bevor die Werte geschrieben werden.
Wenn die einzigen definierten Einstellungen Anwendungsbereichseinstellungen sind, hat sie keine Auswirkung und gibt keinen Fehler zurück, Save wenn sie mit der Standardeinstellung LocalFileSettingsProvideraufgerufen wird. LocalFileSettingsProvider speichert nur Einstellungen mit Benutzerbereich.
Von Bedeutung
Es gibt keine entsprechende Load-Methode, da die Werte der Anwendungseinstellungen während der Wrapperklasseninitialisierung automatisch geladen werden. Im Gegensatz dazu werden diese Werte nicht automatisch gespeichert, wenn eine Anwendung endet. Daher müssen Sie die Save Methode explizit aufrufen, um die aktuellen Werte der Anwendungseinstellungen beizubehalten. Dies wird in der Closing Regel im Ereignishandler der primären oder enthaltenden Form.
