Bagikan melalui

Menyimpan data dengan metode TableAdapter DBDirect dalam 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.

Tutorial ini memberikan instruksi terperinci untuk menjalankan pernyataan SQL secara langsung terhadap database dengan menggunakan metode DBDirect dari TableAdapter. Metode DBDirect dari TableAdapter memberikan tingkat kontrol yang baik atas pembaruan database Anda. Anda dapat menggunakannya untuk menjalankan pernyataan SQL tertentu dan prosedur tersimpan dengan memanggil metode individu Insert, , Update, dan Delete sesuai kebutuhan aplikasi Anda (dibandingkan dengan metode kelebihan beban Update yang melakukan UPDATEpernyataan , , INSERTdan DELETE semuanya dalam satu panggilan).

Dalam tutorial ini, Anda akan mempelajari cara:

Prasyarat

Langkah-langkah dalam tutorial ini berfungsi dengan Aplikasi .NET Framework Formulir Windows.

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 aplikasi Formulir Windows

Langkah pertama adalah membuat Aplikasi Formulir Windows (.NET Framework). Buat proyek menggunakan jenis proyek Aplikasi Formulir Windows, menggunakan C# atau Visual Basic.

Catatan

Kode untuk tutorial ini tersedia di C# dan Visual Basic. Untuk mengalihkan bahasa kode pada halaman ini antara C# dan Visual Basic, gunakan pengalih bahasa kode di bagian atas halaman di sisi kanan.

Membuat tabel sumber data di database Anda

Langkah ini menggunakan Wizard Konfigurasi Sumber Data untuk membuat sumber data berdasarkan tabel Region dalam database sampel Northwind. Anda harus memiliki akses ke database sampel Northwind untuk membuat koneksi. Untuk informasi tentang menyiapkan database sampel Northwind, lihat Cara: Menginstal database sampel.

Untuk membuat sumber data

  1. Pada menu Data, pilih Perlihatkan Sumber Data.

    Jendela Sumber Data terbuka.

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

  3. Pada layar Pilih Jenis Sumber Data, pilih Database, lalu pilih Berikutnya.

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

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

      -atau-

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

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

  6. Pada layar Simpan string koneksi ke file Konfigurasi Aplikasi, pilih Berikutnya.

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

  8. Pilih tabel Region, lalu pilih Selesai.

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

Menambahkan kontrol ke formulir untuk menampilkan data

Buat kontrol terikat data dengan menarik item dari jendela Sumber Data ke formulir Anda.

Untuk membuat kontrol terikat data pada formulir Windows, tarik node Wilayah utama dari jendela Sumber Data ke formulir.

Kontrol DataGridView dan strip alat (BindingNavigator) untuk menavigasi rekaman muncul di formulir. NorthwindDataSet, RegionTableAdapter, BindingSource, dan BindingNavigator muncul di baki komponen.

Untuk menambahkan tombol yang akan memanggil metode TableAdapter DbDirect individual

  1. Tarik tiga kontrol Button dari Kotak Alat ke Form1 (di bawah RegionDataGridView).

  2. Atur properti Nama dan Teks berikut pada setiap tombol.

    Nama Teks
    InsertButton Sisipan
    UpdateButton Pembaruan
    DeleteButton Hapus

Untuk menambahkan kode untuk menyisipkan rekaman baru ke dalam database

  1. Pilih InsertButton untuk membuat penanganan aktivitas untuk peristiwa klik dan buka formulir Anda di editor kode.

  2. Ganti penanganan aktivitas InsertButton_Click dengan kode berikut:

    private void InsertButton_Click(object sender, EventArgs e)
{
    Int32 newRegionID = 5;
    String newRegionDescription = "NorthEastern";

    try
    {
        regionTableAdapter1.Insert(newRegionID, newRegionDescription);
    }
    catch (Exception ex)
    {
        MessageBox.Show("Insert Failed");
    }
    RefreshDataset();
}


private void RefreshDataset()
{
    this.regionTableAdapter1.Fill(this.northwindDataSet1.Region);
}

    Catatan

    Bergantung pada versi Visual Studio Anda dan template proyek yang Anda gunakan, nama variabel seperti regionTableAdapter atau regionTableAdapter1 digunakan dalam kode ini mungkin atau mungkin tidak memiliki 1 berikutnya dalam kode yang dihasilkan. Lakukan koreksi dalam kode Anda untuk memastikan bahwa nama yang benar digunakan di mana-mana. Visual Studio menunjukkan squiggle merah apabila namanya salah.

Untuk menambahkan kode untuk memperbarui rekaman dalam database

  1. Klik dua kali UpdateButton untuk membuat penanganan aktivitas untuk peristiwa klik dan buka formulir Anda di editor kode.

  2. Ganti penanganan aktivitas UpdateButton_Click dengan kode berikut:

    private void UpdateButton_Click(object sender, EventArgs e)
{
    Int32 newRegionID = 5;
    
    try
    {
        regionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern");
    }
    catch (Exception ex)
    {
        MessageBox.Show("Update Failed");
    }
    RefreshDataset();
}

Untuk menambahkan kode untuk menghapus rekaman dari database

  1. Pilih DeleteButton untuk membuat penanganan aktivitas untuk peristiwa klik dan buka formulir Anda di editor kode.

  2. Ganti penanganan aktivitas DeleteButton_Click dengan kode berikut:

    private void DeleteButton_Click(object sender, EventArgs e)
{
    try
    {
        regionTableAdapter1.Delete(5, "Updated Region Description");
    }
    catch (Exception ex)
    {
        MessageBox.Show("Delete Failed");
    }
    RefreshDataset();
}

Jalankan aplikasi

  • Pilih F5 untuk menjalankan aplikasi.

  • Pilih tombol Sisipkan, dan verifikasi bahwa rekaman baru muncul di kisi.

  • Pilih tombol Perbarui, dan verifikasi bahwa rekaman diperbarui di kisi.

  • Pilih tombol Hapus, dan verifikasi bahwa rekaman dihapus dari kisi.

Langkah berikutnya

Bergantung pada persyaratan aplikasi Anda, ada beberapa langkah yang mungkin ingin Anda lakukan setelah membuat formulir terikat data. Beberapa peningkatan yang dapat Anda lakukan untuk tutorial ini meliputi:

  • Menambahkan fungsionalitas pencarian ke formulir.

  • Menambahkan tabel tambahan ke himpunan data dengan memilih Konfigurasi Himpunan Data dengan Wizard dari dalam jendela Sumber Data. Anda dapat menambahkan kontrol yang menampilkan data terkait dengan menarik node terkait ke formulir. Untuk informasi selengkapnya, lihat Hubungan dalam Himpunan Data.

Konten terkait