Cara: Membuat Grid Properti untuk Pengaturan Pengguna di Visual Basic

Anda dapat membuat kisi properti untuk pengaturan pengguna dengan mengisi kontrol PropertyGrid dengan properti pengaturan pengguna dari objek My.Settings.

Nota

Agar contoh ini berfungsi, aplikasi Anda harus mengonfigurasi pengaturan penggunanya. Untuk informasi selengkapnya, lihat Mengelola Pengaturan Aplikasi (.NET).

Objek My.Settings mengekspos setiap pengaturan sebagai properti. Nama properti sama dengan nama pengaturan, dan jenis properti sama dengan jenis pengaturan. Cakupan pengaturan menentukan apakah properti bersifat baca-saja; properti untuk pengaturan Cakupan Aplikasi bersifat baca-saja, sementara properti untuk pengaturan Cakupan Pengguna bersifat baca-tulis. Untuk informasi selengkapnya, lihat Objek My.Settings.

Nota

Anda tidak dapat mengubah atau menyimpan nilai pengaturan cakupan aplikasi pada waktu proses. Pengaturan cakupan aplikasi hanya dapat diubah saat membuat aplikasi (melalui Perancang Proyek) atau dengan mengedit file konfigurasi aplikasi. Untuk informasi selengkapnya, lihat Mengelola Pengaturan Aplikasi (.NET).

Contoh ini menggunakan PropertyGrid kontrol untuk mengakses properti objek My.Settings pengaturan pengguna. Secara default, PropertyGrid menampilkan semua properti My.Settings objek. Namun, properti pengaturan pengguna memiliki UserScopedSettingAttribute atribut . Contoh ini mengatur properti BrowsableAttributes dari PropertyGrid menjadi UserScopedSettingAttribute agar hanya menampilkan properti pengaturan pengguna.

Untuk menambahkan grid properti pengaturan pengguna

  1. Tambahkan kontrol PropertyGrid dari Kotak Alat ke permukaan desain untuk aplikasi Anda, diasumsikan di sini adalah Form1.

    Nama default dari kontrol grid properti adalah PropertyGrid1.

  2. Klik dua kali pada permukaan desain Form1 untuk membuka kode penanganan kejadian pemuatan formulir.

  3. Atur My.Settings objek sebagai objek yang dipilih untuk grid properti.

    PropertyGrid1.SelectedObject = My.Settings

  4. Konfigurasikan kisi properti untuk hanya menampilkan pengaturan pengguna.

    ' Attribute for the user-scope settings.
Dim userAttr As New System.Configuration.UserScopedSettingAttribute
Dim attrs As New System.ComponentModel.AttributeCollection(userAttr)
PropertyGrid1.BrowsableAttributes = attrs

    Nota

    Untuk hanya menampilkan pengaturan cakupan aplikasi, gunakan ApplicationScopedSettingAttribute atribut alih-alih UserScopedSettingAttribute.

Pemrograman yang Kuat

Aplikasi menyimpan pengaturan pengguna saat aplikasi dimatikan. Untuk segera menyimpan pengaturan, panggil My.Settings.Save metode . Untuk informasi selengkapnya, lihat Cara: Mempertahankan Pengaturan Pengguna di Visual Basic.

Lihat juga

  • Last updated on