SqlDependency Kelas

  • Referensi

Definisi

Ruang nama:
System.Data.SqlClient
Rakitan:
System.Data.SqlClient.dll
Rakitan:
System.Data.dll
Paket:
System.Data.SqlClient v4.8.6

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
Object
SqlDependency

Keterangan

SqlDependency sangat ideal untuk skenario penembolokan, di mana aplikasi ASP.NET atau layanan tingkat menengah Anda perlu menyimpan informasi tertentu yang di-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 Membangun Solusi Pemberitahuan.

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 dari instans Type saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari 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 .

Berlaku untuk

Lihat juga