Bagikan melalui


Menambahkan kontrol kustom ke jendela Sumber Data untuk aplikasi .NET Framework

Catatan

Himpunan data dan kelas terkait adalah teknologi .NET Framework warisan dari awal 2000-an yang memungkinkan aplikasi untuk bekerja dengan data dalam memori saat aplikasi terputus dari database. Himpunan data tersebut sangat berguna untuk aplikasi yang mengaktifkan pengguna guna memodifikasi data dan mempertahankan perubahan kembali ke database. Meskipun himpunan data telah terbukti menjadi teknologi yang sangat sukses, sebaiknya aplikasi .NET baru menggunakan Entity Framework Core. Entity Framework menyediakan cara yang lebih alami untuk bekerja dengan data tabular sebagai model objek, dan memiliki antarmuka pemrograman yang lebih sederhana.

Saat Anda menyeret item dari jendela Sumber Data ke permukaan desain untuk membuat kontrol terikat data, Anda bisa memilih jenis kontrol yang Anda buat. Setiap item di jendela memiliki daftar dropdown yang menampilkan kontrol yang dapat Anda pilih. Kumpulan kontrol yang terkait dengan setiap item ditentukan oleh jenis data item tersebut. Jika kontrol yang ingin Anda buat tidak muncul dalam daftar, Anda dapat mengikuti instruksi dalam topik ini untuk menambahkan kontrol ke daftar.

Untuk informasi selengkapnya tentang memilih kontrol terikat data yang akan dibuat untuk item di jendela Sumber Data, lihat Mengatur kontrol yang akan dibuat saat menyeret dari jendela Sumber Data.

Menyesuaikan daftar kontrol yang dapat diikat

Untuk menambah atau menghapus kontrol dari daftar kontrol yang tersedia untuk item di jendela Sumber Data yang memiliki jenis data tertentu, lakukan langkah-langkah berikut.

Untuk memilih kontrol yang akan dicantumkan untuk jenis data

  1. Pastikan Perancang WPF atau Perancang Formulir Windows terbuka.

  2. Di jendela Sumber Data, klik item yang merupakan bagian dari sumber data yang Anda tambahkan ke jendela, lalu klik menu daftar dropdown untuk item tersebut.

    Tip

    Jika jendela Sumber Data tidak terbuka, buka dengan memilih Lihat>Windows Lainnya>Sumber Data.

  3. Di menu daftar menurun, klik Kustomisasi. Salah satu kotak dialog berikut akan terbuka:

    • Jika Perancang Formulir Windows terbuka, halaman Penyesuaian Antarmuka Pengguna Data dari kotak dialog Opsi akan terbuka. Untuk informasi selengkapnya, lihat kotak dialog Opsi Penyesuaian Antarmuka Pengguna Data.

    • Jika Perancang WPF terbuka, kotak dialog Sesuaikan Pengikatan Kontrol terbuka.

  4. Dalam kotak dialog, pilih jenis data dari daftar dropdown Jenis data.

    • Untuk menyesuaikan daftar kontrol untuk tabel atau objek, pilih [Daftar].

    • Untuk menyesuaikan daftar kontrol untuk kolom tabel atau properti objek, pilih jenis data kolom atau properti di penyimpanan data yang mendasari.

    • Untuk menyesuaikan daftar kontrol untuk menampilkan objek data yang memiliki bentuk yang ditentukan pengguna, pilih [Lainnya]. Misalnya, pilih [Lainnya] jika aplikasi Anda memiliki kontrol kustom yang menampilkan data dari lebih dari satu properti objek tertentu.

  5. Di kotak Kontrol terkait, pilih setiap kontrol yang Anda inginkan tersedia untuk jenis data yang dipilih, atau kosongkan pilihan kontrol yang ingin Anda hapus dari daftar.

    Catatan

    Jika kontrol yang ingin Anda pilih tidak muncul di kotak Kontrol terkait, Anda harus menambahkan kontrol ke daftar. Untuk informasi selengkapnya, lihat Menambahkan kontrol terkait.

  6. Klik OK.

  7. Di jendela Sumber Data, klik item tipe data yang baru saja Anda kaitkan dengan satu atau beberapa kontrol, lalu klik menu daftar dropdown untuk item tersebut.

    Kontrol yang Anda pilih dalam kotak Kontrol terkait sekarang muncul di menu daftar dropdown untuk item tersebut.

Menambahkan kontrol terkait

Jika Anda ingin mengaitkan kontrol dengan jenis data, tetapi kontrol tidak muncul di kotak Kontrol terkait, Anda harus menambahkan kontrol ke daftar. Kontrol harus ditempatkan di solusi saat ini atau di rakitan yang direferensikan. Kontrol juga harus tersedia di Kotak Alat dan memiliki atribut yang menentukan perilaku pengikatan data kontrol.

Untuk menambahkan kontrol ke daftar kontrol terkait:

  1. Tambahkan kontrol yang diinginkan ke Kotak Alat dengan mengklik kanan Kotak Alat dan memilih Pilih Item.

    Kontrol harus memiliki salah satu atribut berikut:

    Atribut Deskripsi
    DefaultBindingPropertyAttribute Terapkan atribut ini pada kontrol sederhana yang menampilkan satu kolom (atau properti) data, seperti TextBox.
    ComplexBindingPropertiesAttribute Terapkan atribut ini pada kontrol yang menampilkan daftar (atau tabel) data, seperti DataGridView.
    LookupBindingPropertiesAttribute Terapkan atribut ini pada kontrol yang menampilkan daftar (atau tabel) data, tetapi juga perlu menampilkan satu kolom atau properti, seperti ComboBox.
  2. Untuk Formulir Windows, pada kotak dialog Opsi, buka halaman Penyesuaian Antarmuka Pengguna Data. Atau, untuk WPF, buka kotak dialog Sesuaikan Pengikatan Kontrol. Untuk informasi selengkapnya, lihat Menyesuaikan daftar kontrol yang dapat diikat untuk jenis data.

  3. Di kotak Kontrol terkait, kontrol yang baru saja Anda tambahkan ke Kotak Alat sekarang akan muncul.

    Catatan

    Hanya kontrol yang terletak di dalam solusi saat ini atau di rakitan yang direferensikan yang dapat ditambahkan ke daftar kontrol terkait. (Kontrol juga harus menerapkan salah satu atribut pengikatan data di tabel sebelumnya.) Untuk mengikat data ke kontrol kustom yang tidak tersedia di jendela Sumber Data, seret kontrol dari Kotak Alat ke permukaan desain, lalu seret item yang akan diikat dari jendela Sumber Data ke kontrol.