ApplicationSettingsBase.Upgrade Metode

Definisi

Ruang nama:

System.Configuration

Rakitan:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Sumber:

ApplicationSettingsBase.cs

Updates pengaturan aplikasi untuk mencerminkan penginstalan aplikasi yang lebih baru.

public:
 virtual void Upgrade();

public virtual void Upgrade ();

abstract member Upgrade : unit -> unit
override this.Upgrade : unit -> unit

Public Overridable Sub Upgrade ()

Pengecualian

ConfigurationErrorsException

File konfigurasi tidak dapat diurai.

Keterangan

Metode ini Upgrade melakukan dua tindakan untuk memastikan transisi yang lancar ke versi baru aplikasi:

• Ini memberi tahu semua penyedia pengaturan yang sesuai tentang keberadaan aplikasi yang ditingkatkan melalui panggilan ke metode mereka IApplicationSettingsProvider.Upgrade , dengan asumsi mereka telah mengimplementasikan IApplicationSettingsProvider antarmuka. Tindakan ini tidak dilakukan jika kelas pembungkus pengaturan ditandai dengan NoSettingsVersionUpgradeAttribute.

• Ini memuat ulang nilai untuk semua pengaturan aplikasi.

Anda dapat mengambil alih perilaku Upgrade default untuk menerapkan perilaku peningkatan atau penggabungan kustom. GetPreviousVersion Gunakan metode untuk mengambil nilai individual untuk pengaturan untuk versi aplikasi sebelumnya. Contoh perilaku peningkatan kustom meliputi:

• Menggunakan default kebijakan baru yang mengambil alih satu atau beberapa nilai yang ditentukan pengguna sebelumnya atau default sebelumnya.

• Terjemahan khusus nilai lama agar kompatibel dengan rentang yang lebih baru, grup properti pengaturan yang berbeda, dan sebagainya.

Lihat juga

• Providers
• Reload()
• GetPreviousVersion(String)
• NoSettingsVersionUpgradeAttribute
• Upgrade(SettingsContext, SettingsPropertyCollection)