ApplicationSettingsBase.Save Methode

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

ApplicationSettingsBase.cs

Speichert die aktuellen Werte der Anwendungseinstellungseigenschaften.

public:
 override void Save();

public override void Save ();

override this.Save : unit -> unit

Public Overrides Sub Save ()

Beispiele

Das folgende Codebeispiel zeigt die Methode, die SaveClosing vom Ereignishandler für das primäre Formular aufgerufen wird. Diese Methode fügt auch einen zusätzlichen Punkt an die Einstellungseigenschaft an, die der Eigenschaft des Formulars Text zugeordnet ist.

Das vollständige Codebeispiel ist 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 = Me.Text + "."c

    ' Save size settings manually.
    frmSettings1.FormSize = Me.Size

    frmSettings1.Save()
End Sub

Hinweise

Die Save -Methode schreibt den aktuellen Wert jeder Einstellungseigenschaft in den zugeordneten Datenspeicher. Für jede Eigenschaft ruft diese Methode die SetPropertyValues -Methode für den zugeordneten Einstellungsanbieter auf.

Diese Methode unterscheidet sich von der Basisklassenimplementierung dadurch, dass sie das SettingsSaving Ereignis auslöst, bevor die Werte geschrieben werden.

Wenn die einzigen definierten Einstellungen anwendungsbezogene Einstellungen sind, Save haben keine Auswirkungen und geben keinen Fehler zurück, wenn mit dem Standard LocalFileSettingsProvideraufgerufen wird. LocalFileSettingsProvider speichert nur benutzerbezogene Einstellungen.

Wichtig

Es gibt keine entsprechende Load-Methode, da die Werte der Anwendungseinstellungen während der Initialisierung der Wrapperklasse 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 des primären oder enthaltenden Formausgeführt.

Weitere Informationen

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