Bagikan melalui


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:

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.