ApplicationSettingsBase.Save Metoda

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Pakiet:

System.Configuration.ConfigurationManager v8.0.0

Źródło:

ApplicationSettingsBase.cs

Przechowuje bieżące wartości właściwości ustawień aplikacji.

public:
 override void Save();

public override void Save ();

override this.Save : unit -> unit

Public Overrides Sub Save ()

Przykłady

Poniższy przykład kodu przedstawia metodę wywoływaną Save z Closing programu obsługi zdarzeń dla formularza podstawowego. Ta metoda dołącza również dodatkowy okres do właściwości ustawień skojarzonej z właściwością formularza Text .

Pełny przykład kodu znajduje się na liście w przeglądzie ApplicationSettingsBase klasy.

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

Uwagi

Metoda Save zapisuje bieżącą wartość każdej właściwości ustawień w skojarzonym magazynie danych. Dla każdej właściwości ta metoda wywołuje metodę SetPropertyValues u dostawcy skojarzonych ustawień.

Ta metoda różni się od implementacji klasy bazowej w tym, że zgłasza SettingsSaving zdarzenie przed zapisem wartości.

Jeśli jedynymi zdefiniowanymi ustawieniami są ustawienia o zakresie aplikacji, Save nie będą miały żadnego efektu i nie zostaną zwrócone żadne błędy w przypadku wywołania z wartością domyślną LocalFileSettingsProvider. LocalFileSettingsProvider Zapisuje tylko ustawienia o zakresie użytkownika.

Ważne

Nie ma odpowiedniej metody Load, ponieważ wartości ustawień aplikacji są automatycznie ładowane podczas inicjowania klasy otoki. Z kolei te wartości nie są automatycznie zapisywane po zakończeniu aplikacji. W związku z tym należy jawnie wywołać metodę Save , aby utrwała bieżące wartości ustawień aplikacji. Jest to zwykle wykonywane w procedurze Closing obsługi zdarzeń podstawowego lub zawierającego Formelement .

Zobacz też

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