SettingsProvider Kelas

Referensi

Definisi

Ruang nama:: System.Configuration

Rakitan:: System.Configuration.ConfigurationManager.dll

Rakitan:: System.dll

Paket:: System.Configuration.ConfigurationManager v6.0.0

Paket:: System.Configuration.ConfigurationManager v7.0.0

Paket:: System.Configuration.ConfigurationManager v8.0.0

Paket:: System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5

Sumber:: SettingsProvider.cs

Sumber:: SettingsProvider.cs

Sumber:: SettingsProvider.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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: Object

ProviderBase
SettingsProvider

Turunan: System.Configuration.LocalFileSettingsProvider

System.Web.ClientServices.Providers.ClientSettingsProvider

System.Web.Profile.ProfileProvider

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 SetPropertyValues ApplicationName.

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:

Jika penyedia dapat memenuhi permintaan yang tersirat oleh atribut , jelas itu harus melakukannya.
Jika penyedia tidak dapat memenuhi permintaan, penyedia harus mengabaikannya secara diam-diam.
Jika dua properti atau lebih bertentangan; misalnya, properti yang dihiasi dengan dan ApplicationScopedSettingAttribute UserScopedSettingAttribute; 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