LocalFileSettingsProvider.Upgrade Metode

Definisi

Ruang nama:

System.Configuration

Rakitan:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Sumber:

LocalFileSettingsProvider.cs

Mencoba memigrasikan pengaturan terlingkup pengguna sebelumnya dari versi sebelumnya dari aplikasi yang sama.

public:
 virtual void Upgrade(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyCollection ^ properties);

public void Upgrade (System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyCollection properties);

abstract member Upgrade : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyCollection -> unit
override this.Upgrade : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyCollection -> unit

Public Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)

Parameter

context

SettingsContext

Yang SettingsContext menjelaskan penggunaan aplikasi saat ini.

properties

SettingsPropertyCollection

Yang SettingsPropertyCollection berisi grup properti pengaturan yang nilainya akan diambil.

Penerapan

Upgrade(SettingsContext, SettingsPropertyCollection)

Pengecualian

ConfigurationErrorsException

Pengaturan cakupan pengguna ditemukan tetapi konfigurasi saat ini hanya mendukung pengaturan cakupan aplikasi.

-atau-

Versi sebelumnya dari file konfigurasi tidak dapat diakses.

Keterangan

LocalFileSettingsProvider memigrasikan pengaturan lokal dan roaming dalam operasi terpisah.

Metode Upgrade ini ditekan untuk setiap pengaturan aplikasi yang telah NoSettingsVersionUpgradeAttribute diterapkan padanya, atau ke seluruh kelas pembungkus pengaturan, berasal dari ApplicationSettingsBase.

Dengan cara ini metode ini disebut tergantung pada jenis aplikasi yang sedang ditingkatkan:

• Setiap versi aplikasi ClickOnce disimpan dalam direktori penginstalan terisolasinya sendiri. Setelah versi baru aplikasi ClickOnce diinstal, dan ketika versi baru pertama kali dijalankan, logika internal akan secara otomatis memanggil Upgrade untuk memigrasikan semua pengaturan aplikasi umum ke versi baru. Untuk informasi selengkapnya, lihat ClickOnce dan Pengaturan Aplikasi.

• Aplikasi Formulir Windows dan konsol standar harus memanggil Upgradesecara manual , karena tidak ada cara umum dan otomatis untuk menentukan kapan aplikasi tersebut pertama kali dijalankan. Dua cara umum untuk melakukan ini adalah dari program penginstalan atau menggunakan dari aplikasi itu sendiri, menggunakan properti yang bertahan, sering dinamai sesuatu seperti IsFirstRun.

Perhatikan bahwa agar versi yang lebih baru dapat memigrasikan pengaturan aplikasi, versi tersebut juga harus dapat memuat dan membaca versi pengaturan aplikasi yang lebih lama. Oleh karena itu, harus berisi kelas pembungkus yang kompatibel dengan versi aplikasi baru dan sebelumnya.

Lihat juga

• GetPreviousVersion(SettingsContext, SettingsProperty)
• Reset(SettingsContext)
• IApplicationSettingsProvider
• NoSettingsVersionUpgradeAttribute