ApplicationSettingsBase.Save Metode

Definisi

Ruang nama:

System.Configuration

Rakitan:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Sumber:

ApplicationSettingsBase.cs

Menyimpan nilai properti pengaturan aplikasi saat ini.

public:
 override void Save();

public override void Save ();

override this.Save : unit -> unit

Public Overrides Sub Save ()

Contoh

Contoh kode berikut menunjukkan metode yang Save dipanggil dari penanganan Closing aktivitas untuk formulir utama. Metode ini juga menambahkan periode tambahan ke properti pengaturan yang terkait dengan properti formulir Text .

Contoh kode lengkap tercantum dalam gambaran ApplicationSettingsBase umum kelas.

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

Keterangan

Metode menulis Save nilai saat ini dari setiap properti pengaturan ke penyimpanan data terkait. Untuk setiap properti, metode ini memanggil SetPropertyValues metode pada penyedia pengaturan terkait.

Metode ini berbeda dari implementasi kelas dasar karena meningkatkan SettingsSaving peristiwa sebelum nilai ditulis.

Jika satu-satunya pengaturan yang ditentukan adalah pengaturan cakupan aplikasi, Save tidak akan berpengaruh dan tidak mengembalikan kesalahan jika dipanggil dengan default LocalFileSettingsProvider. LocalFileSettingsProvider hanya menyimpan pengaturan yang terlingkup pengguna.

Penting

Tidak ada metode Muat yang sesuai karena nilai pengaturan aplikasi secara otomatis dimuat selama inisialisasi kelas pembungkus. Sebaliknya, nilai-nilai ini tidak disimpan secara otomatis saat aplikasi berakhir. Oleh karena itu, Anda harus secara eksplisit memanggil Save metode untuk mempertahankan nilai pengaturan aplikasi saat ini. Ini biasanya dilakukan dalam Closing penanganan aktivitas primer atau berisi Form.

Lihat juga

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