IApplicationSettingsProvider Antarmuka

Definisi

Ruang nama:

System.Configuration

Rakitan:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Sumber:

IApplicationSettingsProvider.cs

Menentukan kemampuan yang diperluas untuk penyedia pengaturan aplikasi berbasis klien.

public interface class IApplicationSettingsProvider

public interface IApplicationSettingsProvider

type IApplicationSettingsProvider = interface

Public Interface IApplicationSettingsProvider

Turunan

System.Configuration.LocalFileSettingsProvider

System.Web.ClientServices.Providers.ClientSettingsProvider

Keterangan

Arsitektur pengaturan aplikasi memungkinkan Anda menyediakan mekanisme penyimpanan kustom untuk pengaturan aplikasi dengan membuat penyedia pengaturan kustom, yang merupakan kelas yang berasal dari SettingsProvider. Kelas seperti itu berisi fungsionalitas dasar untuk menyimpan dan mengambil properti. Namun, Anda dapat menambahkan fungsionalitas standar tambahan dengan menerapkan IApplicationSettingsProvider antarmuka di penyedia pengaturan kustom. Antarmuka ini berisi tiga metode yang terutama memungkinkan penyedia pengaturan untuk menangani perubahan versi aplikasi dengan lebih cerdas. Biasanya, penyedia pengaturan akan menyimpan pengaturan aplikasi untuk berbagai versi aplikasi secara terpisah untuk mengantisipasi keadaan berikut:

• Eksekusi berdampingan dari berbagai versi aplikasi.

• Mempertahankan pengaturan aplikasi saat memutakhirkan aplikasi.

• Mengatur ulang pengaturan aplikasi ke nilai defaultnya untuk versi yang saat ini digunakan.

Kelas LocalFileSettingsProvider menerapkan antarmuka IApplicationSettingsProvider. Serangkaian metode yang sama yang terkandung juga IApplicationSettingsProvider ditemukan di ApplicationSettingsBase kelas , memungkinkan pembentukan saluran komunikasi yang telah ditentukan sebelumnya antara pembungkus pengaturan aplikasi dan penyedia pengaturannya.

Catatan

Antarmuka ini bersifat opsional. Jika penyedia tidak menerapkan antarmuka ini, infrastruktur pengaturan akan gagal tanpa pemberitahuan jika mencoba mengakses salah satu metode yang ditentukan oleh antarmuka ini.

Metode

GetPreviousVersion(SettingsContext, SettingsProperty)	Mengembalikan nilai properti pengaturan yang ditentukan untuk versi sebelumnya dari aplikasi yang sama.
Reset(SettingsContext)	Mereset pengaturan aplikasi yang terkait dengan aplikasi yang ditentukan ke nilai defaultnya.
Upgrade(SettingsContext, SettingsPropertyCollection)	Menunjukkan kepada penyedia bahwa aplikasi telah ditingkatkan. Ini menawarkan penyedia kesempatan untuk meningkatkan pengaturan tersimpannya sebagaimana mewajarinya.

Lihat juga

• SettingsProvider
• ApplicationSettingsBase
• Arsitektur pengaturan aplikasi