ApplicationSettingsBase.Item[String] Properti

Definisi

Ruang nama:

System.Configuration

Rakitan:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Sumber:

ApplicationSettingsBase.cs

Mendapatkan atau menetapkan nilai properti pengaturan aplikasi yang ditentukan.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ propertyName); void set(System::String ^ propertyName, System::Object ^ value); };

public override object this[string propertyName] { get; set; }

member this.Item(string) : obj with get, set

Default Public Overrides Property Item(propertyName As String) As Object

Parameter

propertyName

String

yang String berisi nama properti untuk diakses.

Nilai Properti

Object

Jika ditemukan, nilai properti pengaturan bernama; jika tidak, null.

Pengecualian

SettingsPropertyNotFoundException

Tidak ada properti yang terkait dengan pembungkus saat ini atau properti yang ditentukan tidak dapat ditemukan.

SettingsPropertyIsReadOnlyException

Upaya dilakukan untuk menyetel properti baca-saja.

SettingsPropertyWrongTypeException

Nilai yang disediakan adalah jenis yang tidak kompatibel dengan properti pengaturan, selama operasi yang ditetapkan.

ConfigurationErrorsException

File konfigurasi tidak dapat diurai.

Keterangan

Properti Item[] , juga dikenal sebagai pengindeks, secara rutin digunakan dalam kelas pembungkus pengaturan yang berasal dari ApplicationSettingsBase. Item[] mengikat properti publik kelas pembungkus ke properti pengaturan yang sesuai.

Item[] meningkatkan beberapa peristiwa tergantung pada operasi yang dilakukan:

• Pertama kali properti diambil, SettingsLoaded peristiwa dinaikkan.

• Saat properti diatur, OnSettingChanging peristiwa akan dinaikkan. Jika handler tidak membatalkan acara, maka nilai properti diatur dan PropertyChanged peristiwa dinaikkan.

Lihat juga

• Properties
• IsReadOnly