Bagikan melalui


LocalFileSettingsProvider Kelas

Definisi

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
LocalFileSettingsProvider
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.

Berlaku untuk

Lihat juga