Bagikan melalui

Membuat kueri TableAdapter berparameter di aplikasi .NET Framework

  • 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.

Kueri berparameter mengembalikan data yang memenuhi kondisi WHERE klausa dalam kueri. Misalnya, Anda dapat membuat parameter daftar pelanggan untuk menampilkan hanya pelanggan di kota tertentu dengan menambahkan WHERE City = @City ke akhir pernyataan SQL yang mengembalikan daftar pelanggan.

Anda membuat kueri TableAdapter berparameter di Perancang Himpunan Data. Anda juga dapat membuatnya di aplikasi Windows dengan perintah Buat Parameter Sumber Data pada menu Data. Perintah Buat Parameter Sumber Data membuat kontrol pada formulir tempat Anda dapat memasukkan nilai parameter dan menjalankan kueri.

Catatan

Saat membuat kueri berparameter, gunakan notasi parameter yang khusus untuk database yang Anda kodekan. Misalnya, sumber data Access dan OleDb menggunakan tanda tanya '?' untuk menunjukkan parameter, sehingga WHERE klausul akan terlihat seperti ini: WHERE City = ?.

Membuat kueri TableAdapter berparameter

Untuk membuat kueri berparameter di Perancang Himpunan Data

  • Buat TableAdapter baru, tambahkan WHERE klausa dengan parameter yang diinginkan ke pernyataan SQL. Untuk informasi selengkapnya, lihat Membuat dan mengonfigurasi TableAdapters.

    or

  • Tambahkan kueri ke TableAdapter yang sudah ada, menambahkan klausa dengan parameter yang WHERE diinginkan ke pernyataan SQL.

Untuk membuat kueri berparameter saat merancang formulir terikat data

  1. Pilih kontrol pada formulir Anda yang sudah terikat ke himpunan data. Untuk informasi selengkapnya, lihat Mengikat kontrol Formulir Windows ke data di Visual Studio.

  2. Pada menu Data, pilih Tambahkan Kueri.

  3. Selesaikan kotak dialog Penyusun Kriteria Pencarian, tambahkan WHERE klausa dengan parameter yang diinginkan ke pernyataan SQL.

Untuk menambahkan kueri ke formulir terikat data yang sudah ada

  1. Buka formulir di Perancang Formulir Windows.

  2. Pada menu Data, pilih Tambahkan Kueri atau Tag Cerdas Data.

    Catatan

    Jika Tambahkan Kueri tidak tersedia pada menu Data, pilih kontrol pada formulir yang menampilkan sumber data yang ingin Anda tambahkan parameterisasi. Misalnya, jika formulir menampilkan data dalam kontrol DataGridView, pilihlah. Jika formulir menampilkan data dalam kontrol individual, pilih kontrol terikat data apa pun.

  3. Di area Pilih tabel sumber data, pilih tabel yang ingin Anda tambahkan parameterisasi.

  4. Ketik nama dalam kotak Nama kueri baru jika Anda membuat kueri baru.

    or

    Pilih kueri dalam kotak Nama kueri yang sudah ada.

  5. Dalam kotak Teks Kueri, ketik kueri yang mengambil parameter.

  6. Pilih OK.

    Kontrol untuk memasukkan parameter dan tombol Muat ditambahkan ke formulir dalam kontrol ToolStrip.

Kueri untuk nilai null

Parameter TableAdapter dapat ditetapkan nilai null saat Anda ingin mengkueri rekaman yang tidak memiliki nilai saat ini. Misalnya, pertimbangkan kueri berikut yang memiliki parameter ShippedDate dalam klausul WHERE-nya :

SELECT CustomerID, OrderDate, ShippedDate
FROM Orders
WHERE (ShippedDate = @ShippedDate) OR (ShippedDate IS NULL)

Jika ini adalah kueri di TableAdapter, Anda dapat mengkueri semua pesanan yang belum dikirim dengan kode berikut:

ordersTableAdapter.FillByShippedDate(northwindDataSet.Orders, null);

Untuk mengaktifkan kueri untuk menerima nilai null:

  1. Di Perancang Himpunan Data, pilih kueri TableAdapter yang perlu menerima nilai parameter null.

  2. Di jendela Properti, pilih Parameter, lalu klik tombol elipsis (...) untuk membuka Editor Koleksi Parameter.

  3. Pilih parameter yang memungkinkan nilai null dan atur properti AllowDbNull ke true.

Konten terkait