Bagikan melalui


Mengirim data di antara formulir

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.

Tutorial ini memberikan instruksi langkah demi langkah untuk meneruskan data dari satu formulir ke formulir lainnya. Dengan menggunakan tabel Pelanggan dan Pesanan dari database sampel Northwind, satu formulir memungkinkan pengguna untuk memilih pelanggan, dan formulir kedua menampilkan pesanan pelanggan yang dipilih. Tutorial ini menunjukkan cara membuat metode pada formulir kedua yang menerima data dari formulir pertama.

Dalam tutorial ini, Anda menyelesaikan tugas-tugas berikut:

  • Buat proyek Aplikasi Formulir Windows (.NET Framework) baru.
  • Membuat dan mengonfigurasi himpunan data dengan menggunakan Wizard Konfigurasi Sumber Data.
  • Pilih kontrol untuk dibuat pada formulir saat Anda menyeret item dari jendela Sumber Data . Untuk informasi selengkapnya, lihat Mengatur kontrol yang akan dibuat saat menyeret dari jendela Sumber Data.
  • Buat kontrol terikat data dengan menyeret item dari jendela Sumber Data ke formulir.
  • Buat formulir kedua dengan kisi yang menampilkan data.
  • Buat TableAdapter kueri untuk mengambil pesanan untuk pelanggan tertentu.
  • Meneruskan data antar formulir.

Nota

Tutorial ini hanya menunjukkan satu cara untuk meneruskan data antar formulir. Ada opsi lain untuk meneruskan data ke formulir, seperti membuat konstruktor kedua untuk menerima data, atau membuat properti publik yang dapat diatur dengan data dari formulir pertama.

Prasyarat

  • Beban kerja pengembangan desktop .NET dan penyimpanan dan pemrosesan data yang diinstal di Visual Studio. Untuk menginstalnya, buka Penginstal Visual Studio dan pilih Ubah, atauUbah>, di samping versi Visual Studio yang ingin Anda gunakan. Untuk informasi selengkapnya, lihat Memodifikasi Visual Studio.

  • SQL Server Express 2019 LocalDB diinstal baik dari halaman unduhan SQL Server, atau melalui Alat Penginstal Visual Studio sebagai bagian dari penyimpanan Data dan beban kerja pemrosesan.

  • Database sampel Northwind, dibuat dengan mengikuti langkah-langkah berikut:

    1. Di Visual Studio, buka jendela SQL Server Object Explorer dengan memilihnya dari menu Tampilan . SQL Server Object Explorer diinstal sebagai bagian dari penyimpanan Data dan beban kerja pemrosesan .

    2. Perluas simpul SQL Server , klik kanan instans LocalDB Anda, dan pilih Kueri Baru untuk membuka jendela editor kueri.

    3. Salin skrip northwind Transact-SQL ke clipboard Anda. Skrip T-SQL ini membuat database Northwind dan mengisinya dengan data.

    4. Tempelkan skrip T-SQL ke editor kueri, lalu pilih Jalankan di bagian atas jendela untuk membuat database Northwind.

Membuat proyek aplikasi Windows Forms

  1. Di Visual Studio, pada menu File, pilihProyek>.

  2. Pilih C# atau Visual Basic dari daftar dropdown Semua bahasa , Windows dari daftar dropdown Semua platform , dan Desktop dari daftar Semua jenis proyek .

  3. Pilih Aplikasi Formulir Windows (.NET Framework) dari daftar templat proyek, lalu pilih Berikutnya.

  4. Beri nama proyek PassingDataBetweenForms, pilih Berikutnya, lalu pilih Buat.

Proyek PassingDataBetweenForms dibuat dan ditambahkan ke Penjelajah Solusi. Tampilan desainer Form1 muncul di editor.

Membuat sumber data

  1. Buka jendela Sumber Data dengan memilih Proyek>Tambahkan Sumber Data Baru pada menu Visual Studio.

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

  3. Pada halaman Pilih Tipe Sumber Data , pilih Database, lalu pilih Berikutnya.

  4. Pada halaman Pilih Model Database , verifikasi bahwa Himpunan Data ditentukan dan pilih Berikutnya.

  5. Pada halaman Pilih Koneksi Data Anda , jika koneksi data ke database sampel Northwind sudah tersedia, pilih, dan lanjutkan ke langkah Pilih Objek Database Anda . Jika tidak, pilih Koneksi Baru.

  6. Pada layar Pilih Sumber Data , pilih File Database Microsoft SQL Server, lalu pilih Lanjutkan.

  7. Pada layar Tambahkan Koneksi , pilih Telusuri, telusuri dan pilih file northwnd.mdf , dan pilih Buka.

  8. Pilih Autentikasi Windows, atau pilih Autentikasi SQL Server dan berikan nama pengguna dan kata sandi untuk mengakses database.

  9. Pilih Uji Koneksi untuk menguji koneksi. Saat koneksi berhasil, pilih OK.

  10. Pada halaman Pilih Koneksi Data Anda , konfirmasikan bahwa file database muncul dan pilih Berikutnya.

  11. Pilih Tidak ke pertanyaan popup Ingin menyalin file ke proyek Anda dan mengubah koneksi?

  12. Pada halaman Simpan String Koneksi ke file Konfigurasi Aplikasi , pilih Ya. Beri nama koneksi NorthwindConnectionString, lalu pilih Berikutnya.

  13. Pada halaman Pilih Objek Database Anda , perluas simpul Tabel , pilih tabel Pelanggan dan Pesanan , beri nama himpunan data NorthwindDataSet, lalu pilih Selesai.

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

Mengisi formulir pertama

Membuat formulir kedua

Buat formulir kedua untuk mengoper data.

  1. Dari menu Proyek , pilih Tambahkan Formulir (Formulir Windows).

  2. Biarkan nama default Form2, dan pilih Tambahkan.

  3. Seret simpul Pesanan utama dari jendela Sumber Data ke Form2.

    DataGridView dan BindingNavigator bilah alat untuk menavigasi rekaman muncul di Form2. NorthwindDataSet, CustomersTableAdapter, BindingSource, dan BindingNavigator muncul di baki komponen.

  4. Hapus OrdersBindingNavigator dari baki komponen. BindingNavigator menghilang dari Form2.

Menambahkan kueri TableAdapter

TableAdapter Tambahkan kueri ke Form2 yang memuat pesanan untuk pelanggan yang dipilih di Form1.

  1. Klik dua kali file NorthwindDataSet.xsd di Penjelajah Solusi.

  2. Klik kanan OrdersTableAdapter dalam tabel Pesanan , dan pilih Tambahkan>Kueri.

  3. Biarkan opsi default Gunakan pernyataan SQL dan pilih Berikutnya.

  4. Biarkan opsi default SELECT yang mengembalikan baris dan pilih Berikutnya.

  5. Di Data apa yang harus dimuat oleh tabel, untuk mengembalikan Orders berdasarkan CustomerID, tambahkan WHERE klausa ke dalam akhir kueri. Kueri akhir akan terlihat mirip dengan kode berikut:

    SELECT OrderID, CustomerID, OrderDate, RequiredDate, ShippedDate, ShipVia, Freight, ShipName, ShipAddress, ShipCity, ShipRegion, ShipPostalCode, ShipCountry
    FROM Orders
    WHERE CustomerID = @CustomerID
    

    Nota

    Gunakan sintaks parameter yang benar untuk database Anda. Misalnya, di Microsoft Access, WHERE klausul akan terlihat seperti WHERE CustomerID = ?.

  6. Pilih Berikutnya.

  7. Pada layar Pilih Metode untuk Menghasilkan, pilih Isi TabelData dan masukkan FillByCustomerID.

  8. Hapus centang opsi Kembalikan DataTable, lalu pilih Selesai.

Membuat metode di Form2 untuk meneruskan data ke

  1. Klik kanan di Form2 dan pilih Tampilkan Kode untuk membuka kode Form2 di editor.

  2. Dalam kode Form2 , hapus konten Form2_Load metode , dan tambahkan kode berikut setelah Form2_Load metode :

internal void LoadOrders(String CustomerID)
{
    ordersTableAdapter.FillByCustomerID(northwindDataSet.Orders, CustomerID);
}

Membuat metode di Form1 untuk meneruskan data dan menampilkan Form2

  1. Dalam tampilan Perancang Form1, klik kanan kisi data Pelanggan, lalu pilih Properti.

  2. Di jendela Properti , pilih ikon Peristiwa di toolbar atas.

  3. Klik dua kali peristiwa DoubleClick untuk membuka editor kode.

  4. Di editor kode, perbarui definisi metode agar sesuai dengan sampel berikut:

private void customersDataGridView_DoubleClick(object sender, EventArgs e)
{
    System.Data.DataRowView SelectedRowView;
    NorthwindDataSet.CustomersRow SelectedRow;

    SelectedRowView = (System.Data.DataRowView)customersBindingSource.Current;
    SelectedRow = (NorthwindDataSet.CustomersRow)SelectedRowView.Row;

    Form2 OrdersForm = new Form2();
    OrdersForm.LoadOrders(SelectedRow.CustomerID);
    OrdersForm.Show();
}

Menjalankan dan menguji aplikasi

  1. Tekan F5 untuk menjalankan aplikasi.

  2. Dalam aplikasi, klik dua kali catatan pelanggan di Form1 untuk membuka Form2 dengan pesanan pelanggan tersebut.

Langkah selanjutnya

Bergantung pada persyaratan aplikasi, Anda dapat melakukan beberapa langkah setelah meneruskan data antar formulir. Beberapa penyempurnaan yang dapat Anda lakukan untuk tutorial ini meliputi: