SqlDependency.Start Metode

Definisi

Ruang nama:
System.Data.SqlClient
Rakitan:
System.Data.dll

Memulai pendengar untuk menerima pemberitahuan perubahan dependensi.

Overload

Nama Deskripsi
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.

Keterangan

Listener SqlDependency akan memulai ulang ketika terjadi kesalahan dalam koneksi SQL Server.

Beberapa panggilan ke Start metode dapat dilakukan, tunduk pada batasan berikut:

  • Beberapa panggilan dengan parameter yang identik (kredensial string koneksi dan Windows yang sama di utas panggilan) valid.

  • Beberapa panggilan dengan string koneksi yang berbeda valid selama:

    • Setiap string koneksi menentukan database yang berbeda, atau

    • Setiap string koneksi menentukan pengguna lain, atau

    • Panggilan berasal dari domain aplikasi yang berbeda.

Anda dapat membuat SqlDependency pekerjaan dengan benar untuk aplikasi yang menggunakan beberapa utas untuk mewakili kredensial pengguna yang berbeda tanpa memberikan peran dbo ke grup, karena pengguna yang berbeda dapat berlangganan dan mendengarkan (menggunakan SqlCacheDependency atau SqlCommand) ke antrean pemberitahuan yang dibuat oleh administrator. Saat domain aplikasi yang relevan dimulai, panggil Mulai dengan kredensial (Windows) pengguna yang memiliki izin untuk menginisialisasi layanan/antrean (izin CREATE QUEUE dan CREATE SERVICE untuk database). Pastikan Bahwa Mulai hanya dipanggil sekali per AppDomain, jika tidak, pengecualian ambiguitas dinaikkan. Utas pengguna harus memiliki izin untuk berlangganan pemberitahuan (izin BERLANGGANAN PEMBERITAHUAN KUERI untuk database). SqlDependency akan mengaitkan permintaan langganan pengguna non-administrator ke layanan/antrean yang dibuat oleh administrator.

Start(String)

Sumber:
System.Data.SqlClient.notsupported.cs

Memulai pendengar untuk menerima pemberitahuan perubahan dependensi dari instans SQL Server yang ditentukan oleh string koneksi.

public:
 static bool Start(System::String ^ connectionString);
public static bool Start(string connectionString);
static member Start : string -> bool
Public Shared Function Start (connectionString As String) As Boolean

Parameter

connectionString
String

string koneksi untuk instans SQL Server untuk mendapatkan pemberitahuan perubahan.

Mengembalikan

Boolean

true jika pendengar berhasil diinisialisasi; false jika pendengar yang kompatibel sudah ada.

Pengecualian

ArgumentNullException

Parameternya connectionString adalah NULL.

InvalidOperationException

Parameter connectionString sama dengan panggilan sebelumnya ke metode ini, tetapi parameternya berbeda.

Metode ini dipanggil dari dalam CLR.

SecurityException

Pemanggil tidak memiliki izin keamanan akses kode (CAS) yang diperlukan SqlClientPermission .

SqlException

Panggilan berikutnya ke metode telah dilakukan dengan parameter yang setara connectionString dengan pengguna yang berbeda, atau pengguna yang tidak default ke skema yang sama.

Selain itu, setiap pengecualian SqlClient yang mendasar.

Keterangan

Metode ini memulai listener untuk AppDomain untuk menerima pemberitahuan dependensi dari instans SQL Server yang ditentukan oleh parameter connectionString. Metode ini dapat dipanggil lebih dari sekali dengan string koneksi yang berbeda untuk beberapa server.

Untuk keterangan tambahan, lihat Start.

Lihat juga

Berlaku untuk

Start(String, String)

Sumber:
System.Data.SqlClient.notsupported.cs

Memulai pendengar untuk menerima pemberitahuan perubahan dependensi dari instans SQL Server yang ditentukan oleh string koneksi menggunakan antrean SQL Server Service Broker yang ditentukan.

public:
 static bool Start(System::String ^ connectionString, System::String ^ queue);
public static bool Start(string connectionString, string queue);
static member Start : string * string -> bool
Public Shared Function Start (connectionString As String, queue As String) As Boolean

Parameter

connectionString
String

string koneksi untuk instans SQL Server untuk mendapatkan pemberitahuan perubahan.

queue
String

Antrean Service Broker SQL Server yang ada untuk digunakan. Jika null, antrean default digunakan.

Mengembalikan

Boolean

true jika pendengar berhasil diinisialisasi; false jika pendengar yang kompatibel sudah ada.

Pengecualian

ArgumentNullException

Parameternya connectionString adalah NULL.

InvalidOperationException

Parameter connectionString sama dengan panggilan sebelumnya ke metode ini, tetapi parameternya berbeda.

Metode ini dipanggil dari dalam CLR.

SecurityException

Pemanggil tidak memiliki izin keamanan akses kode (CAS) yang diperlukan SqlClientPermission .

SqlException

Panggilan berikutnya ke metode telah dilakukan dengan parameter yang setara connectionString tetapi pengguna yang berbeda, atau pengguna yang tidak default ke skema yang sama.

Selain itu, setiap pengecualian SqlClient yang mendasar.

Keterangan

Metode ini memulai listener untuk AppDomain untuk menerima pemberitahuan dependensi dari instans SQL Server yang ditentukan oleh parameter connectionString. Metode ini dapat dipanggil lebih dari sekali dengan string koneksi yang berbeda untuk beberapa server.

Jika tidak ada nama antrean yang ditentukan, SqlDependency buat antrean dan layanan sementara di server yang digunakan untuk seluruh proses, bahkan jika prosesnya melibatkan lebih dari satu AppDomain. Antrean dan layanan secara otomatis dihapus saat aplikasi dimatikan.

Untuk keterangan tambahan, lihat Start.

Lihat juga

Berlaku untuk