Bagikan melalui

Membuat kontrol pengguna .NET Framework Formulir Windows yang mendukung pengikatan data kompleks dengan ADO.NET

  • Artikel

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 menampilkan data pada formulir dalam aplikasi Windows, Anda dapat memilih kontrol yang ada dari Kotak Alat. Atau, Anda dapat menulis kontrol kustom jika aplikasi Anda memerlukan fungsionalitas yang tidak tersedia dalam kontrol standar. Panduan ini menunjukkan cara membuat kontrol yang mengimplementasikan ComplexBindingPropertiesAttribute. Kontrol yang mengimplementasikan properti ComplexBindingPropertiesAttribute dan DataSource berisi DataMember yang dapat terikat ke data. Kontrol tersebut mirip dengan DataGridView atau ListBox.

Untuk informasi selengkapnya tentang penulisan kontrol, lihat Mengembangkan kontrol Formulir Windows pada waktu desain.

Saat membuat kontrol untuk digunakan dalam skenario pengikatan data, Anda perlu menerapkan salah satu atribut pengikatan data berikut:

Penggunaan atribut pengikatan data
Terapkan DefaultBindingPropertyAttribute pada kontrol sederhana, seperti TextBox, yang menampilkan satu kolom (atau properti) data. Untuk informasi selengkapnya, lihat Membuat kontrol pengguna Formulir Windows yang mendukung pengikatan data sederhana.
Terapkan ComplexBindingPropertiesAttribute pada kontrol, seperti DataGridView, yang menampilkan daftar (atau tabel) data. (Proses ini dijelaskan di halaman panduan ini.)
Terapkan LookupBindingPropertiesAttribute pada kontrol, seperti ComboBox, yang menampilkan daftar (atau tabel) data tetapi juga perlu menyajikan satu kolom atau properti. Untuk informasi selengkapnya, lihat Membuat kontrol pengguna Formulir Windows yang mendukung pengikatan data pencarian.

Panduan ini membuat kontrol kompleks yang menampilkan baris data dari tabel. Contoh ini menggunakan tabel Customers dari database sampel Northwind. Kontrol pengguna yang kompleks akan menampilkan tabel pelanggan dalam DataGridView kontrol kustom.

Selama panduan ini, Anda akan mempelajari cara:

  • Tambahkan Kontrol Pengguna baru ke proyek Anda.

  • Merancang kontrol pengguna secara visual.

  • Terapkan atribut ComplexBindingProperty.

  • Buat himpunan data dengan Wizard Konfigurasi Sumber Data.

  • Atur tabel Pelanggan di jendela Sumber Data untuk menggunakan kontrol kompleks baru.

  • Tambahkan kontrol baru dengan menyeretnya dari jendela Sumber Data ke Form1.

Prasyarat

Untuk menyelesaikan tutorial ini, Anda memerlukan beban kerja pengembangan desktop .NET dan Penyimpanan data dan pemrosesan yang diinstal di Visual Studio. Untuk menginstalnya, buka penginstal Visual Studio, lalu pilih Ubah(atau Lebih> Ubah) di samping versi Visual Studio yang ingin Anda ubah. Lihat Ubah Visual Studio.

Panduan ini menggunakan SQL Server Express LocalDB dan database sampel Northwind.

  1. Jika Anda tidak memiliki SQL Server Express LocalDB, pasang dari halaman unduhan SQL Server Express, atau melalui Alat Penginstal Visual Studio. Di Alat Penginstal Visual Studio, Anda dapat memasang SQL Server Express LocalDB sebagai bagian dari beban kerja Penyimpanan dan pemrosesan data, atau sebagai komponen individual.

  2. Instal database sampel Northwind dengan mengikuti langkah-langkah berikut:

    1. Di Visual Studio, buka jendela SQL Server Object Explorer. (SQL Server Object Explorer dipasang sebagai bagian dari beban kerja Penyimpanan dan pemrosesan data di Alat Penginstal Visual Studio.) Perluas node SQL Server. Klik kanan pada instans LocalDB Anda dan pilih Kueri Baru.

      Jendela editor kueri terbuka.

    2. Salin skrip Northwind Transact-SQL ke clipboard Anda. Skrip T-SQL ini membuat database Northwind dari awal dan mengisinya dengan data.

    3. Tempelkan skrip T-SQL ke editor kueri, lalu pilih tombol Jalankan.

      Setelah beberapa saat, kueri selesai berjalan dan database Northwind dibuat.

Membuat proyek aplikasi Formulir Windows

Langkah pertama adalah membuat proyek Aplikasi Formulir Windows untuk C# atau Visual Basic. Beri nama proyek ComplexControlWalkthrough.

Menambahkan kontrol pengguna ke proyek

Karena panduan ini membuat kontrol yang dapat mengikat data yang kompleks dari Kontrol Pengguna, tambahkan item Kontrol Pengguna ke proyek:

  1. Dari menu Proyek, pilih Tambahkan Kontrol Pengguna.

  2. Ketik ComplexDataGridView di area Nama, lalu klik Tambahkan.

    Kontrol ComplexDataGridView ditambahkan ke Penjelajah Solusi, dan buka di perancang.

Mendesain kontrol ComplexDataGridView

Untuk menambahkan DataGridView ke kontrol pengguna, seret DataGridView dari Kotak Alat ke permukaan desain kontrol pengguna.

Menambahkan atribut pengikatan data yang diperlukan

Untuk kontrol kompleks yang mendukung pengikatan data, Anda dapat menerapkan ComplexBindingPropertiesAttribute:

  1. Alihkan kontrol ComplexDataGridView ke tampilan kode. (Pada menu Tampilan, pilih Kode.)

  2. Ganti kode di ComplexDataGridView dengan kode berikut:

    using System.Windows.Forms;

namespace CS
{
    [System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")]
    public partial class ComplexDataGridView : UserControl
    {
        public object DataSource
        {
            get{ return dataGridView1.DataSource; }
            set{ dataGridView1.DataSource = value; }
        }

        public string DataMember
        {
            get{ return dataGridView1.DataMember; }
            set{ dataGridView1.DataMember = value; }
        }

        public ComplexDataGridView()
        {
            InitializeComponent();
        }
    }
}

  3. Dari menu Build, pilih Build Solution.

Membuat tabel sumber data di database Anda

Gunakan wizard Konfigurasi Sumber Data untuk membuat sumber data berdasarkan tabel Customers dalam database sampel Northwind:

  1. Untuk membuka jendela Sumber Data, pada menu Data, klik Perlihatkan Sumber Data.

  2. Di jendela Sumber Data, pilih Tambahkan Sumber Data Baru untuk memulai wizard Konfigurasi Sumber Data.

  3. Pilih Database pada halaman Pilih Jenis Sumber Data, lalu klik Berikutnya.

  4. Pada halaman Pilih Koneksi Data Anda lakukan salah satu hal berikut ini:

    • Jika koneksi data ke database sampel Northwind tersedia di daftar dropdown, pilihlah.

    • Pilih Koneksi Baru untuk meluncurkan kotak dialog Tambahkan/Ubah Koneksi.

  5. Jika database Anda memerlukan kata sandi, pilih opsi untuk menyertakan data sensitif, lalu klik Berikutnya.

  6. Pada halaman Simpan string koneksi ke file Konfigurasi Aplikasi, klik Berikutnya.

  7. Pada halaman Pilih Objek Database Anda, perluas node Tabel.

  8. Pilih tabel Customers, lalu klik Selesai.

    NorthwindDataSet ditambahkan ke proyek Anda, dan tabel Customers muncul di jendela Sumber Data.

Mengatur tabel Pelanggan untuk menggunakan kontrol ComplexDataGridView

Dalam jendela Sumber Data, Anda bisa mengatur kontrol yang akan dibuat sebelum menyeret item ke formulir Anda:

  1. Buka Formulir1 di perancang.

  2. Perluas node Pelanggan di jendela Sumber Data.

  3. Klik panah daftar dropdown pada simpul Pelanggan , dan pilih Kustomisasi.

  4. Pilih ComplexDataGridView dari daftar Kontrol Terkait dalam kotak dialog Opsi Kustomisasi UI Data.

  5. Klik panah daftar dropdown pada Customers tabel, dan pilih ComplexDataGridView dari daftar kontrol.

Menambahkan kontrol ke formulir

Anda dapat membuat kontrol terikat data dengan menyeret item dari jendela Sumber Data ke formulir Anda. Seret node Pelanggan utama dari jendela Sumber Data ke formulir. Verifikasi bahwa kontrol ComplexDataGridView digunakan untuk menampilkan data tabel.

Jalankan aplikasi

Tekan F5 untuk menjalankan aplikasi.

Langkah berikutnya

Bergantung pada persyaratan aplikasi Anda, ada beberapa langkah yang mungkin ingin Anda lakukan setelah membuat kontrol yang mendukung pengikatan data. Beberapa langkah umum berikutnya meliputi:

Konten terkait