SqlDependency Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Objek SqlDependency mewakili dependensi pemberitahuan kueri antara aplikasi dan instans SQL Server. Aplikasi dapat membuat SqlDependency objek dan mendaftar untuk menerima pemberitahuan melalui penanganan OnChangeEventHandler aktivitas.
public ref class SqlDependency sealed
public sealed class SqlDependency
type SqlDependency = class
Public NotInheritable Class SqlDependency
- Warisan
-
SqlDependency
Keterangan
SqlDependency sangat ideal untuk skenario penembolokan, di mana aplikasi ASP.NET atau layanan tingkat menengah Anda perlu menyimpan informasi tertentu dalam cache dalam memori. SqlDependency memungkinkan Anda menerima pemberitahuan ketika data asli dalam database berubah sehingga cache dapat disegarkan.
Untuk menyiapkan dependensi, Anda perlu mengaitkan SqlDependency objek ke satu atau beberapa SqlCommand objek. Untuk menerima pemberitahuan, Anda perlu berlangganan acara OnChange . Untuk informasi selengkapnya tentang persyaratan untuk membuat kueri untuk pemberitahuan, lihat Bekerja dengan Pemberitahuan Kueri.
Catatan
SqlDependency dirancang untuk digunakan dalam layanan ASP.NET atau tingkat menengah di mana ada sejumlah kecil server yang memiliki dependensi aktif terhadap database. Ini tidak dirancang untuk digunakan dalam aplikasi klien, di mana ratusan atau ribuan komputer klien akan memiliki SqlDependency objek yang disiapkan untuk satu server database. Jika Anda mengembangkan aplikasi yang memerlukan pemberitahuan sub-detik yang andal saat data berubah, tinjau bagian Merencanakan Strategi Pemberitahuan Kueri yang Efisien dan Alternatif untuk Pemberitahuan Kueri di Perencanaan untuk artikel Notifikasi.
Untuk informasi selengkapnya, lihat Pemberitahuan Kueri di SQL Server dan Solusi Pemberitahuan Bangunan.
Catatan
Peristiwa OnChange dapat dihasilkan pada utas yang berbeda dari utas yang memulai eksekusi perintah.
Pemberitahuan kueri hanya didukung untuk pernyataan SELECT yang memenuhi daftar persyaratan tertentu.
Konstruktor
SqlDependency() |
Membuat instans SqlDependency baru kelas dengan pengaturan default. |
SqlDependency(SqlCommand) |
Membuat instans SqlDependency baru kelas dan mengaitkannya dengan SqlCommand parameter . |
SqlDependency(SqlCommand, String, Int32) |
Membuat instans SqlDependency baru kelas, mengaitkannya dengan SqlCommand parameter, dan menentukan opsi pemberitahuan dan nilai waktu habis. |
Properti
HasChanges |
Mendapatkan nilai yang menunjukkan apakah salah satu kumpulan hasil yang terkait dengan dependensi telah berubah. |
Id |
Mendapatkan nilai yang secara unik mengidentifikasi instans SqlDependency kelas ini. |
Metode
AddCommandDependency(SqlCommand) |
Mengaitkan objek dengan instans SqlCommand ini SqlDependency . |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
Start(String) |
Memulai pendengar untuk menerima pemberitahuan perubahan dependensi dari instans SQL Server yang ditentukan oleh string koneksi. |
Start(String, String) |
Memulai pendengar untuk menerima pemberitahuan perubahan dependensi dari instans SQL Server yang ditentukan oleh string koneksi menggunakan antrean SQL Server Service Broker yang ditentukan. |
Stop(String) |
Menghentikan pendengar untuk koneksi yang ditentukan dalam panggilan sebelumnya Start . |
Stop(String, String) |
Menghentikan pendengar untuk koneksi yang ditentukan dalam panggilan sebelumnya Start . |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Acara
OnChange |
Terjadi ketika pemberitahuan diterima untuk salah satu perintah yang terkait dengan objek ini SqlDependency . |