Metode DataContext (Perancang O/R)
Metode DataContext (dalam konteks Alat LINQ ke SQL dalam Visual Studio) merupakan metode kelas DataContext yang menjalankan prosedur dan fungsi tersimpan dalam database.
Kelas DataContext adalah kelas LINQ ke SQL yang bertindak sebagai saluran antara database SQL Server dan kelas entitas LINQ ke SQL yang dipetakan ke database tersebut. Kelas DataContext berisi informasi string koneksi dan metode untuk menghubungkan ke database dan memanipulasi data dalam database. Secara default, kelas DataContext berisi beberapa metode yang dapat Anda panggil, seperti metode SubmitChanges yang mengirim data yang diperbarui dari kelas LINQ ke SQL ke database. Anda juga dapat membuat metode DataContext tambahan yang memetakan ke prosedur dan fungsi tersimpan. Dengan kata lain, memanggil metode kustom ini akan menjalankan prosedur atau fungsi tersimpan dalam database tempat metode DataContext dipetakan. Anda dapat menambahkan metode baru ke kelas DataContext sama seperti Anda menambahkan metode untuk memperluas kelas apa pun. Tetapi, dalam diskusi tentang metode DataContext dalam konteks Perancang O/R, merupakan metode DataContext yang memetakan ke prosedur dan fungsi tersimpan yang sedang dibahas.
Panel metode
Metode DataContext yang dipetakan ke prosedur dan fungsi tersimpan ditampilkan di panel Metode pada Perancang O/R. Panel Metode adalah panel di sepanjang sisi panel Entitas (permukaan desain utama). Panel Metode mencantumkan semua metode DataContext yang Anda buat dengan menggunakan Perancang O/R. Secara default, panel Metode kosong; seret prosedur atau fungsi tersimpan dari Server Explorer atau Penjelajah Database ke Perancang O/R untuk membuat metode DataContext dan mengisi panel Metode. Untuk informasi selengkapnya, lihat Cara: Membuat metode DataContext yang dipetakan ke prosedur dan fungsi tersimpan (Perancang O/R).
Catatan
Buka dan tutup panel metode dengan mengklik kanan Perancang O/R lalu mengklik Sembunyikan Panel Metode atau Tampilkan Panel Metode, atau gunakan pintasan CTRL+1.
Dua jenis metode DataContext
Metode DataContext adalah metode yang memetakan ke prosedur dan fungsi tersimpan dalam database. Anda dapat membuat dan menambahkan metode DataContext pada panel Metode pada Perancang O/R. Ada dua jenis metode DataContext yang berbeda; yang menampilkan satu atau lebih kumpulan hasil, dan yang tidak menampilkan kumpulan hasil:
Metode DataContext yang menampilkan satu atau beberapa kumpulan hasil:
Buat metode DataContext semacam ini ketika aplikasi Anda hanya perlu menjalankan prosedur dan fungsi tersimpan dalam database dan menampilkan hasilnya. Untuk informasi selengkapnya, lihat Cara: Membuat metode DataContext yang dipetakan ke prosedur dan fungsi tersimpan (Perancang O/R), System.Data.Linq.ISingleResult<T>, dan IMultipleResults.
Metode DataContext yang tidak menampilkan kumpulan hasil: seperti Penyisipan, Pembaruan, dan Penghapusan untuk kelas entitas tertentu.
Buat metode DataContext semacam ini saat aplikasi Anda harus menjalankan prosedur tersimpan, bukan menggunakan perilaku LINQ ke SQL default untuk menyimpan data yang diubah antara kelas entitas dan database. Untuk informasi selengkapnya, lihat Cara: Menetapkan prosedur tersimpan untuk melakukan pembaruan, penyisipan, dan penghapusan (O/R Designer) .
Menampilkan Jenis Metode DataContext
Saat Anda menyeret prosedur dan fungsi tersimpan dari Server Explorer atau Database Explorer ke O/R Designer , jenis pengembalian metode DataContext yang dihasilkan berbeda tergantung di mana Anda menjatuhkan item. Meletakkan item secara langsung ke kelas entitas yang ada akan membuat metode DataContext dengan jenis pengembalian kelas entitas; meletakkan item ke area kosong Perancang O/R (di salah satu panel) membuat metode DataContext yang mengembalikan jenis yang dibuat secara otomatis. Jenis yang dibuat secara otomatis memiliki nama yang cocok dengan prosedur tersimpan atau nama fungsi serta properti, yang dipetakan ke bidang yang dikembalikan oleh prosedur atau fungsi tersimpan.
Catatan
Anda dapat mengubah jenis DataContext pengembalian metode setelah menambahkannya ke panel metode. Untuk memeriksa atau mengubah jenis pengembalian metode DataContext, pilih dan periksa properti Jenis Pengembalian di jendela Properti. Untuk informasi selengkapnya, lihat Cara: Mengubah jenis pengembalian metode DataContext (Perancang O/R).
Objek yang Anda seret dari database ke permukaan Perancang O/R diberi nama secara otomatis, berdasarkan nama objek dalam database. Jika Anda menyeret objek yang sama lebih dari sekali, angka akan ditambahkan ke akhir nama baru yang membedakan nama tersebut. Ketika nama objek database berisi spasi, atau karakter yang tidak didukung dalam Visual Basic atau C#, spasi atau karakter yang tidak valid diganti dengan garis bawah.
Konten terkait
- Alat LINQ to SQL di Visual Studio
- LINQ ke SQL
- Prosedur tersimpan
- Cara: Membuat metode DataContext yang dipetakan ke prosedur dan fungsi tersimpan (Perancang O/R)
- Cara: Menetapkan prosedur tersimpan untuk melakukan pembaruan, penyisipan, dan penghapusan (O/R Designer)
- Panduan: Menyesuaikan perilaku menyisipkan, memperbarui, dan menghapus kelas entitas
- Panduan: Membuat kelas LINQ ke SQL (Perancang O/R)