SettingsPropertyValue.PropertyValue Properti

Definisi

Ruang nama:

System.Configuration

Rakitan:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Sumber:

SettingsPropertyValue.cs

Mendapatkan atau mengatur nilai SettingsProperty objek.

public:
 property System::Object ^ PropertyValue { System::Object ^ get(); void set(System::Object ^ value); };

public object PropertyValue { get; set; }

member this.PropertyValue : obj with get, set

Public Property PropertyValue As Object

Nilai Properti

Object

Nilai SettingsProperty objek . Ketika nilai ini diatur, IsDirty properti diatur ke true dan UsingDefaultValue diatur ke false.

Ketika nilai pertama kali diakses dari PropertyValue properti, dan jika nilai awalnya disimpan ke dalam SettingsPropertyValue objek sebagai representasi berseri menggunakan SerializedValue properti , PropertyValue properti akan memicu deserialisasi nilai yang mendasar. Sebagai efek samping, Deserialized properti akan diatur ke true.

Jika rantai peristiwa ini terjadi di ASP.NET, dan jika terjadi kesalahan selama proses deserialisasi, kesalahan dicatat menggunakan fitur pemantauan kesehatan ASP.NET. Secara default, ini berarti bahwa kesalahan deserialisasi akan muncul di Log Peristiwa Aplikasi saat berjalan di bawah ASP.NET. Jika proses ini terjadi di luar ASP.NET, dan jika terjadi kesalahan selama deserialisasi, kesalahan ditekan, dan sisa logika selama deserialisasi terjadi. Jika tidak ada nilai berseri untuk deserialisasi saat deserialisasi dicoba, maka SettingsPropertyValue objek akan mencoba mengembalikan nilai default jika dikonfigurasi seperti yang ditentukan pada instans terkait SettingsProperty . Dalam hal ini, jika DefaultValue properti diatur ke null, atau ke string "[null]", maka SettingsPropertyValue objek akan menginisialisasi PropertyValue properti ke untuk null jenis referensi, atau ke nilai default untuk jenis nilai terkait. Di sisi lain, jika DefaultValue properti menyimpan referensi objek atau nilai string yang valid (selain "[null]"), maka DefaultValue properti dikembalikan sebagai gantinya.

Jika tidak ada nilai berseri untuk deserialisasi ketika deserialisasi dicoba, dan tidak ada nilai default yang ditentukan, maka string kosong akan dikembalikan untuk jenis string. Untuk semua jenis lainnya, instans default akan dikembalikan dengan memanggil CreateInstance(Type) - untuk jenis referensi ini berarti upaya akan dilakukan untuk membuat instans objek menggunakan konstruktor tanpa parameter. Jika upaya ini gagal, maka null dikembalikan.

Pengecualian

ArgumentException

Saat mencoba menggunakan nilai default dari DefaultValue properti , terjadi kesalahan. Upaya untuk mengonversi DefaultValue properti ke jenis yang valid gagal, atau nilai yang dihasilkan tidak kompatibel dengan jenis yang ditentukan oleh PropertyType.