LocalFileSettingsProvider.SetPropertyValues Metode

Definisi

Ruang nama:

System.Configuration

Rakitan:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v9.0.0-preview.5.24306.7

Sumber:

LocalFileSettingsProvider.cs

Mengatur nilai dari grup pengaturan properti yang ditentukan.

public:
 override void SetPropertyValues(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyValueCollection ^ values);

public override void SetPropertyValues (System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyValueCollection values);

override this.SetPropertyValues : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyValueCollection -> unit

Public Overrides Sub SetPropertyValues (context As SettingsContext, values As SettingsPropertyValueCollection)

Parameter

context

SettingsContext

yang SettingsContext menjelaskan penggunaan aplikasi saat ini.

values

SettingsPropertyValueCollection

mewakili SettingsPropertyValueCollection grup pengaturan properti yang akan diatur.

Pengecualian

ConfigurationErrorsException

Pengaturan yang dilingkup pengguna ditemukan tetapi konfigurasi saat ini hanya mendukung pengaturan cakupan aplikasi.

-atau-

Ada kegagalan umum menyimpan pengaturan ke file konfigurasi.

Keterangan

Kelas pembungkus pengaturan, berasal dari ApplicationSettingsBase, berisi Save metode , yang dipanggil untuk mempertahankan nilai semua properti pengaturannya. Metode ini menghitung melalui semua penyedia pengaturan yang terkait dengan properti pengaturannya, dan memanggil SetPropertyValues metode untuk masing-masing SettingsProvider untuk melakukan operasi serialisasi aktual.

SetPropertyValues secara individual menserialisasikan setiap properti pengaturan aplikasi cakupan pengguna ke pengaturan aplikasi yang sesuai dalam file konfigurasi yang sesuai user.config .

Secara default, SetPropertyValues metode ini menggunakan urutan logis berikut untuk menentukan skema serialisasi, tergantung pada jenis properti pengaturan:

1. Jika jenis memiliki yang terkait TypeConverter dengan ConvertToString implementasi metode, konversi ini digunakan.

2. Serialisasi XML digunakan.

Namun, Anda dapat menentukan mekanisme serialisasi pilihan dengan menggunakan SettingsSerializeAsAttribute. LocalFileSettingsProvider tidak mendukung serialisasi biner di Visual Studio 2005.

Jika properti pengaturan cakupan pengguna diatur kembali ke nilai defaultnya secara eksplisit, penyedia pengaturan file lokal akan menghapus entri untuk pengaturan terkait dari file konfigurasi pengguna. Akses baca berikutnya untuk properti ini hanya akan menggunakan nilai default.

Perhatian

LocalFileSettingsProvider tidak menggunakan enkripsi untuk mempertahankan pengaturan apa pun. Oleh karena itu, jangan menyimpan kata sandi teks biasa atau informasi sensitif lainnya menggunakan penyedia ini tanpa mengambil tindakan pencegahan tambahan, seperti mengenkripsi informasi secara terpisah dalam file konfigurasi. Untuk informasi selengkapnya, lihat Mengenkripsi Informasi Konfigurasi Menggunakan Konfigurasi Terproteksi.

Lihat juga

• GetPropertyValues(SettingsContext, SettingsPropertyCollection)
• Save()
• TypeConverter
• SettingsSerializeAsAttribute