Membuat dan mengonfigurasi TableAdapters di 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. Teknologi ini sangat berguna untuk aplikasi yang memungkinkan pengguna 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.

TableAdapters menyediakan komunikasi antara aplikasi Anda dan database. Ini tersambung ke database, menjalankan kueri atau prosedur tersimpan, dan mengembalikan tabel data baru atau mengisi DataTable yang sudah ada dengan data yang dikembalikan. TableAdapters juga dapat mengirim data yang diperbarui dari aplikasi Anda kembali ke database.

TableAdapters dibuat untuk Anda saat Anda melakukan salah satu tindakan berikut:

• Seret objek database dari Penjelajah Server ke dalam Perancang Himpunan Data.

• Jalankan Wizard Konfigurasi Sumber Data, dan pilih jenis sumber data Database atau Layanan Web.

  

Anda juga dapat membuat TableAdapter baru dan mengonfigu rasinya dengan sumber data dengan menarik TableAdapter dari Kotak Alat ke wilayah kosong di permukaan Perancang Himpunan Data.

Untuk pengenalan TableAdapters, lihat Mengisi himpunan data menggunakan TableAdapters.

Catatan

Komputer Anda mungkin menampilkan nama atau lokasi yang berbeda untuk beberapa elemen antarmuka pengguna Visual Studio dalam artikel ini. Anda mungkin menggunakan edisi Visual Studio yang berbeda atau pengaturan lingkungan yang berbeda. Untuk informasi selengkapnya, lihat Mempersonalisasi IDE.

Menggunakan Wizard Konfigurasi TableAdapter

Jalankan Wizard Konfigurasi TableAdapter untuk membuat atau mengedit TableAdapters dan DataTable terkait. Anda dapat mengonfigurasi TableAdapter yang ada dengan mengeklik kanan di Perancang Himpunan Data.

Jika Anda menarik TableAdapter baru dari Kotak Alat saat Perancang Himpunan Data sedang fokus, wizard akan memulai dan meminta Anda untuk menentukan sumber data mana yang harus disambungkan oleh TableAdapter. Pada halaman berikutnya, wizard menanyakan jenis perintah apa yang harus digunakan untuk berkomunikasi dengan database, baik pernyataan SQL atau prosedur tersimpan. (Anda tidak melihat layar ini jika Mengonfigurasi TableAdapter yang sudah terkait dengan sumber data.)

• Anda memiliki opsi untuk membuat prosedur tersimpan baru dalam database yang mendasar jika Anda memiliki izin yang benar untuk database. Jika Anda tidak memiliki izin ini, opsi ini tidak tersedia.

• Anda juga dapat memilih untuk menjalankan prosedur tersimpan yang ada untuk perintah SELECT, INSERT, UPDATE, dan DELETE dari TableAdapter. Prosedur tersimpan yang ditetapkan ke perintah Perbarui, misalnya, dijalankan saat metode TableAdapter.Update() dipanggil.

Parameter peta dari prosedur tersimpan yang dipilih ke kolom terkait dalam tabel data. Misalnya, jika prosedur tersimpan Anda menerima parameter bernama @CompanyName yang diteruskan k kolom CompanyName dalam tabel, atur Kolom Sumber parameter @CompanyName ke CompanyName.

Catatan

Prosedur tersimpan yang ditetapkan ke SELECT perintah dijalankan dengan memanggil metode TableAdapter yang Anda beri nama di langkah wizard berikutnya. Metode default adalah Fill, sehingga kode yang biasanya digunakan untuk menjalankan SELECT prosedur adalah TableAdapter.Fill(tableName). Jika Anda mengubah nama default dari Fill, ganti Fill dengan nama yang Anda tetapkan, dan ganti "TableAdapter" dengan nama aktual TableAdapter (misalnya, CustomersTableAdapter).

• Memilih opsi Buat metode untuk mengirim pembaruan langsung ke database setara dengan mengatur properti GenerateDBDirectMethods ke true. Opsi tidak tersedia saat pernyataan SQL asli tidak memberikan informasi yang cukup atau kueri bukan kueri yang dapat diperbarui. Situasi ini dapat terjadi, misalnya, dalam kueri dan kueri JOIN yang mengembalikan nilai tunggal (skalar).

Opsi Tingkat Lanjut dalam wizard yang memungkinkan Anda untuk:

• Hasilkan INSERTpernyataan , UPDATE, dan DELETE berdasarkan SELECT pernyataan yang ditentukan pada halaman Hasilkan pernyataan SQL
• Gunakan konkurensi optimis
• Tentukan apakah akan me-refresh tabel data setelah INSERT dan UPDATE pernyataan dijalankan

Mengonfigurasi metode Mengisi TableAdapter

Terkadang Anda mungkin ingin mengubah skema tabel TableAdapter. Untuk melakukan ini, Anda memodifikasi metode Fill utama TableAdapter. TableAdapters dibuat dengan metode Fill utama yang menentukan skema tabel data terkait. Metode Fill utama didasarkan pada kueri atau prosedur tersimpan yang Anda masukkan saat Anda awalnya mengonfigurasi TableAdapter. Ini adalah metode pertama (paling atas) di bawah tabel data pada Perancang Himpunan Data.

Setiap perubahan yang Anda buat pada metode Fill utama TableAdapter tercermin dalam skema tabel data terkait. Misalnya, menghapus kolom dari kueri dalam metode Fill utama juga menghapus kolom dari tabel data terkait. Selain itu, menghapus kolom dari metode Fill utama akan menghapus kolom dari kueri tambahan untuk TableAdapter tersebut.

Anda bisa menggunakan Wizard Konfigurasi Kueri TableAdapter untuk membuat dan mengedit kueri tambahan untuk TableAdapter. Kueri tambahan ini harus sesuai dengan skema tabel, kecuali jika mengembalikan nilai skalar. Setiap kueri tambahan memiliki nama yang Anda tentukan.

Contoh berikut ini memperlihatkan kepada Anda cara memanggil kueri tambahan bernama FillByCity:

CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")

Untuk memulai Wizard Konfigurasi Kueri TableAdapter dengan kueri baru

1. Buka himpunan data Anda di Perancang Himpunan Data.

2. Jika Anda membuat kueri baru, seret objek Kueri dari tab Himpunan Data kotak Alat ke DataTable, atau pilih Tambahkan Kueri dari menu pintasan TableAdapter. Anda juga bisa menyeret objek Kueri ke area kosong Desainer Himpunan Data, yang membuat TableAdapter tanpa terkait dengan DataTable. Kueri ini hanya dapat mengembalikan nilai tunggal (skalar), atau menjalankan UPDATEperintah , , INSERTatau DELETE terhadap database.

3. Pada layar Pilih Koneksi Data Anda, pilih, atau buat koneksi yang akan digunakan kueri.

   Catatan

   Layar ini hanya muncul ketika perancang tidak dapat menentukan koneksi yang tepat untuk digunakan, atau ketika tidak ada koneksi yang tersedia.

4. Pada layar Pilih Jenis Perintah, pilih dari metode pengambilan data berikut dari database:

   • Menggunakan pernyataan SQL memungkinkan Anda mengetik pernyataan SQL untuk memilih data dari database Anda.

   • Membuat prosedur tersimpan baru memungkinkan Anda membuat prosedur tersimpan baru (dalam database) berdasarkan pernyataan yang ditentukan SELECT .

   • Menggunakan prosedur tersimpan yang sudah ada memungkinkan Anda menjalankan prosedur tersimpan yang sudah ada saat menjalankan kueri.

Untuk memulai wizard Konfigurasi Kueri TableAdapter pada kueri yang sudah ada

• Jika Anda mengedit kueri TableAdapter yang sudah ada, klik kanan kueri, lalu pilih Konfigurasikan dari menu pintasan.

  Catatan

  Mengklik kanan kueri utama TableAdapter mengonfigurasi ulang TableAdapter dan skema DataTable. Namun, klik kanan kueri tambahan pada TableAdapter, mengonfigurasi kueri yang dipilih saja. Wizard Konfigurasi TableAdapter mengonfigurasi definisi TableAdapter, saat Wizard Konfigurasi Kueri TableAdapter hanya mengonfigurasi kueri yang dipilih.

Untuk menambahkan kueri global ke TableAdapter

• Kueri global adalah kueri SQL yang mengembalikan nilai tunggal (skalar) atau tanpa nilai. Biasanya, fungsi global melakukan operasi database seperti menyisipkan, memperbarui, dan menghapus. Ini juga menggabungkan informasi, seperti jumlah pelanggan dalam tabel atau total biaya untuk semua item dalam pesanan tertentu.

  Anda menambahkan kueri global dengan menarik objek Kueri dari tab Himpunan Data dari Kotak Alat ke area kosong Perancang Himpunan Data.

• Berikan kueri yang melakukan tugas yang diinginkan, misalnya SELECT COUNT(*) AS CustomerCount FROM Customers.

  Catatan

  Menarik objek Kueri langsung ke Perancang Himpunan Data membuat metode yang hanya mengembalikan nilai skalar (tunggal). Meskipun kueri atau prosedur tersimpan yang Anda pilih mungkin mengembalikan lebih dari satu nilai, metode yang dibuat oleh wizard hanya mengembalikan satu nilai. Misalnya, kueri mungkin mengembalikan kolom pertama dari baris pertama dari data yang dikembalikan.

Konten terkait

• Mengisi dataset menggunakan TableAdapters