LocalFileSettingsProvider Kelas
Definisi
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.
Memberikan persistensi untuk kelas pengaturan aplikasi.
public ref class LocalFileSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProvider
public class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider
type LocalFileSettingsProvider = class
inherit SettingsProvider
interface IApplicationSettingsProvider
Public Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider
- Warisan
- Penerapan
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. Properti pengaturan aplikasi atau grup properti dikaitkan dengan penyedia pengaturan tertentu melalui penggunaan SettingsProviderAttribute.
Biasanya, program klien tidak secara eksplisit mengakses kelas ini; sebaliknya, arsitektur pengaturan aplikasi secara otomatis memanggil penyedia pengaturan yang sesuai ketika layanannya diperlukan. Misalnya, banyak anggota mendelegasikan ApplicationSettingsBase pekerjaan mereka ke penyedia pengaturan terkait.
LocalFileSettingsProvider mempertahankan pengaturan ke file konfigurasi yang memiliki ekstensi .config
. Konten file konfigurasi disusun sebagai dokumen XML. Bergantung pada apakah pengaturan dilingkupkan di tingkat aplikasi atau tingkat pengguna, data konfigurasi disimpan sebagai elemen dalam grup bagian <applicationSettings>
atau <userSettings>
, masing-masing. Masing-masing grup bagian ini diwakili oleh atau ClientSettingsSection, yang sesuaiAppSettingsSection. Setiap objek bagian dimiliki dan dikelola oleh handler bagian konfigurasi, yang merupakan objek jenis IConfigurationSectionHandler.
Pengaturan cakupan aplikasi dan pengaturan cakupan pengguna default disimpan dalam file bernama application.exe.config
, yang dibuat dalam direktori yang sama dengan file yang dapat dieksekusi. Pengaturan konfigurasi aplikasi bersifat baca-saja. Data pengguna tertentu disimpan dalam file bernama user.config
, disimpan di bawah direktori beranda pengguna. Jika profil roaming diaktifkan, dua versi file konfigurasi pengguna bisa ada. Dalam kasus seperti itu, entri dalam versi roaming lebih diutamakan daripada entri duplikat dalam file konfigurasi pengguna lokal.
Untuk informasi selengkapnya tentang pengaturan aplikasi, lihat Pengaturan Aplikasi untuk Formulir Windows.
Konstruktor
LocalFileSettingsProvider() |
Menginisialisasi instans baru kelas LocalFileSettingsProvider. |
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 ramah 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) |
GetPreviousVersion(SettingsContext, SettingsProperty) |
Mengembalikan nilai properti pengaturan bernama untuk versi sebelumnya dari aplikasi yang sama. |
GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Mengembalikan kumpulan nilai properti pengaturan untuk instans aplikasi dan grup properti pengaturan yang ditentukan. |
GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
Initialize(String, NameValueCollection) |
Menginisialisasi penyedia. |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
Reset(SettingsContext) |
Mereset semua properti pengaturan aplikasi yang terkait dengan aplikasi yang ditentukan ke nilai defaultnya. |
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Mengatur nilai dari grup pengaturan properti yang ditentukan. |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Upgrade(SettingsContext, SettingsPropertyCollection) |
Mencoba untuk memigrasikan pengaturan terlingkup pengguna sebelumnya dari versi sebelumnya dari aplikasi yang sama. |