ApplicationSettingsBase.Save Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Ukládá aktuální hodnoty vlastností nastavení aplikace.
public:
override void Save();public override void Save ();override this.Save : unit -> unitPublic Overrides Sub Save ()Příklady
Následující příklad kódu ukazuje metodu Save volanou z obslužné Closing rutiny události pro primární formulář. Tato metoda také připojí další tečku k vlastnosti nastavení, která je přidružena k vlastnosti formuláře Text .
Úplný příklad kódu je uveden v přehledu ApplicationSettingsBase třídy.
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
Poznámky
Metoda Save zapisuje aktuální hodnotu každé vlastnosti nastavení do svého přidruženého úložiště dat. Pro každou vlastnost tato metoda volá metodu SetPropertyValues u přidruženého zprostředkovatele nastavení.
Tato metoda se liší od implementace základní třídy v tom, že vyvolá SettingsSaving událost před zápisem hodnot.
Pokud jsou definována pouze nastavení v rámci aplikace, Save nebudou mít žádný vliv a nevrátí žádnou chybu, pokud je volána s výchozím LocalFileSettingsProviderparametrem . LocalFileSettingsProvider ukládá jenom nastavení v oboru uživatele.
Důležité
Neexistuje žádná odpovídající metoda Load, protože hodnoty nastavení aplikace jsou automaticky načteny během inicializace třídy obálky. Naproti tomu tyto hodnoty se při ukončení aplikace automaticky neukládají. Proto je nutné explicitně volat metodu Save k zachování aktuálních hodnot nastavení aplikace. To se obvykle provádí v obslužné rutině Closing události primární nebo obsahující Form.
