ApplicationSettingsBase.Save Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 .