ApplicationSettingsBase.Save Metoda

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Zdroj:

ApplicationSettingsBase.cs

Uloží aktuální hodnoty vlastností nastavení aplikace.

public:
 override void Save();

public override void Save();

override this.Save : unit -> unit

Public Overrides Sub Save ()

Příklady

Následující příklad kódu ukazuje metodu Save volanou Closing z obslužné rutiny události pro primární formulář. Tato metoda také připojí další období k vlastnosti nastavení, která je přidružena Text k vlastnosti formuláře.

Ú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 = Text + "."c

    ' Save size settings manually.
    frmSettings1.FormSize = Size

    frmSettings1.Save()
End Sub

Poznámky

Metoda Save zapíše aktuální hodnotu každé vlastnosti nastavení do 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í s oborem aplikace, Save nebude mít žádný vliv a vrátí žádnou chybu, pokud je volána s výchozí LocalFileSettingsProvider. LocalFileSettingsProvider uloží pouze nastavení s vymezeným uživatelem.

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 pro zachování aktuálních hodnot nastavení aplikace. To se obvykle provádí v Closing obslužné rutině události primárního nebo obsahujícího Form.

Viz také

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