ApplicationSettingsBase.Save Metoda

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v8.0.0

Zdroj:

ApplicationSettingsBase.cs

Ukládá 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 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.

Viz také

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