Bagikan melalui


SettingsProvider Kelas

Definisi

Bertindak sebagai kelas dasar untuk mendapatkan penyedia pengaturan kustom dalam arsitektur pengaturan aplikasi.

public ref class SettingsProvider abstract : System::Configuration::Provider::ProviderBase
public abstract class SettingsProvider : System.Configuration.Provider.ProviderBase
type SettingsProvider = class
    inherit ProviderBase
Public MustInherit Class SettingsProvider
Inherits ProviderBase
Warisan
SettingsProvider
Turunan

Keterangan

Penyedia pengaturan menentukan mekanisme untuk menyimpan data konfigurasi yang digunakan dalam arsitektur pengaturan aplikasi. .NET Framework berisi satu penyedia pengaturan default, LocalFileSettingsProvider, yang menyimpan data konfigurasi ke sistem file lokal. Namun, Anda dapat membuat mekanisme penyimpanan alternatif dengan berasal dari kelas abstrak SettingsProvider . Penyedia yang digunakan kelas pembungkus ditentukan dengan mendekorasi kelas pembungkus dengan SettingsProviderAttribute. Jika atribut ini tidak disediakan, default, LocalFileSettingsProvider, digunakan.

Saat Anda membuat penyedia pengaturan kustom, minimal, Anda harus menyediakan implementasi untuk tiga metode kelas ini: GetPropertyValues, dan SetPropertyValuesApplicationName.

Untuk aplikasi klien, Anda dapat menambahkan fungsionalitas yang lebih standar ke penyedia kustom dengan juga mengimplementasikan IApplicationSettingsProvider antarmuka. Antarmuka ini mencerminkan metode yang ditemukan di ApplicationSettingsBase kelas , yang terutama memungkinkan dukungan penerapan versi.

Biasanya, Anda harus merancang penyedia pengaturan menjadi instans tunggal untuk menghindari ketidakcocokan sumber daya penyimpanan. Penyedia juga harus aman untuk utas karena dapat dipanggil secara bersamaan dari beberapa instans pembungkus dalam satu domain aplikasi atau dari beberapa aplikasi di domain yang berbeda.

Minimal, penyedia pengaturan harus mengenali tiga atribut - ApplicationScopedSettingAttribute, , UserScopedSettingAttributedan DefaultSettingValueAttribute. Untuk daftar lengkap atribut yang dapat diterapkan ke pengaturan aplikasi, lihat Atribut Pengaturan Aplikasi. Penyedia pengaturan kustom harus menyelesaikan atribut yang diterapkan ke properti pengaturan dengan cara berikut:

  1. Jika penyedia dapat memenuhi permintaan yang tersirat oleh atribut , jelas itu harus melakukannya.

  2. Jika penyedia tidak dapat memenuhi permintaan, penyedia harus mengabaikannya secara diam-diam.

  3. Jika dua properti atau lebih bertentangan; misalnya, properti yang dihiasi dengan dan ApplicationScopedSettingAttributeUserScopedSettingAttribute; penyedia harus melemparkan ConfigurationException.

Konstruktor

SettingsProvider()

Menginisialisasi instans SettingsProvider kelas.

Properti

ApplicationName

Mendapatkan atau mengatur nama aplikasi yang sedang berjalan.

Description

Mendapatkan deskripsi singkat dan ramah yang cocok untuk ditampilkan di alat administratif atau antarmuka pengguna (UI) lainnya.

(Diperoleh dari ProviderBase)
Name

Mendapatkan nama yang mudah diingat yang digunakan untuk merujuk ke penyedia selama konfigurasi.

(Diperoleh dari ProviderBase)

Metode

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetPropertyValues(SettingsContext, SettingsPropertyCollection)

Mengembalikan kumpulan nilai properti pengaturan untuk instans aplikasi dan grup properti pengaturan yang ditentukan.

GetType()

Mendapatkan instans Type saat ini.

(Diperoleh dari Object)
Initialize(String, NameValueCollection)

Menginisialisasi penyusun konfigurasi.

(Diperoleh dari ProviderBase)
MemberwiseClone()

Membuat salinan dangkal dari yang saat ini Object.

(Diperoleh dari Object)
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Mengatur nilai dari grup pengaturan properti yang ditentukan.

ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Berlaku untuk

Lihat juga