Bagikan melalui

Membuat kueri TableAdapter berparameter di aplikasi .NET Framework

Nota

Kelas DataSet 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. Teknologi ini sangat berguna untuk aplikasi yang memungkinkan pengguna memodifikasi data dan mempertahankan perubahan kembali ke database. Meskipun himpunan data adalah teknologi yang terbukti berhasil, pendekatan yang direkomendasikan untuk aplikasi .NET baru adalah 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 Parameterisasi Sumber Data pada menu Data . Perintah Parameterize Data Source membuat kontrol pada formulir Tempat Anda dapat memasukkan nilai parameter dan menjalankan kueri.

Nota

Saat membuat kueri berparameter, gunakan notasi parameter yang khusus untuk database yang Anda coding. 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.

    atau

  • Tambahkan kueri ke TableAdapter yang sudah ada, menambahkan klausa WHERE dengan parameter yang 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 Windows Forms 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 Windows Forms Designer.

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

    Nota

    Jika Tambahkan Kueri tidak tersedia pada menu Data , pilih kontrol pada formulir yang menampilkan sumber data yang ingin Anda tambahkan parameterisasinya. Misalnya, jika formulir menampilkan data dalam DataGridView kontrol, 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 parameterisasinya.

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

    atau

    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 ToolStrip kontrol.

Kueri 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 ShippedDate parameter dalam klausulnya WHERE :

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 pilih tombol elipsis (...) untuk membuka Editor Koleksi Parameter.

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

Konten terkait

  • Last updated on