SqlDependency 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
SqlDependency 物件代表應用程式與 SQL Server 實例之間的查詢通知依賴關係。 應用程式可以建立 SqlDependency 物件並註冊以透過事件處理程序接收通知 OnChangeEventHandler 。
public ref class SqlDependency sealedpublic sealed class SqlDependencytype SqlDependency = classPublic NotInheritable Class SqlDependency- 繼承
-
SqlDependency
備註
SqlDependency 非常適合快取情境，因為您的 ASP.NET 應用程式或中階服務需要將某些資訊快取在記憶體中。 SqlDependency 當資料庫原始資料變更時，能收到通知，讓你能重新整理快取。
要建立相依關係，你需要將一個 SqlDependency 物件與一個或多個 SqlCommand 物件關聯。 要接收通知，您需要訂閱活動。OnChange 欲了解更多關於建立通知查詢的要求，請參閱「 使用查詢通知」。
Note
SqlDependency 設計用於 ASP.NET 或中階服務，這些服務中伺服器數量相對較少且對資料庫有依賴。 它並非為用戶端應用程式設計，因為數百甚至數千台用戶端電腦會為 SqlDependency 單一資料庫伺服器設置物件。 如果您正在開發的應用程式需要在數據變更時提供可靠的毫秒級通知，請查看規劃通知文章中的高效規劃查詢通知策略和查詢通知替代方案部分。
欲了解更多資訊，請參閱 SQL Server 中的
Note
事件 OnChange 可能在與啟動指令執行的執行緒不同的執行緒上產生。
只有符合特定需求的SELECT語句才支持查詢通知。
建構函式
| 名稱 | Description |
|---|---|
| SqlDependency() |
建立一個新的類別實例 SqlDependency ，並維持預設設定。 |
| SqlDependency(SqlCommand, String, Int32) |
建立一個新的類別實例 SqlDependency ，將其與 SqlCommand 參數關聯，並指定通知選項及逾時值。 |
| SqlDependency(SqlCommand) |
建立一個新的類別實例 SqlDependency ，並將其與 SqlCommand 參數關聯。 |
屬性
| 名稱 | Description |
|---|---|
| HasChanges |
會得到一個值，表示與相依關係相關的結果集是否改變。 |
| Id |
會獲得一個唯一識別該類別實例 SqlDependency 的值。 |
方法
| 名稱 | Description |
|---|---|
| AddCommandDependency(SqlCommand) |
將物件 SqlCommand 與此 SqlDependency 實例關聯。 |
| Equals(Object) |
判斷指定的 物件是否等於目前的物件。 (繼承來源 Object) |
| GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
| GetType() |
取得目前實例的 Type。 (繼承來源 Object) |
| MemberwiseClone() |
建立目前 Object的淺層複本。 (繼承來源 Object) |
| Start(String, String) |
啟動監聽器，接收由連接字串指定的 SQL Server 實例，使用指定的 SQL Server Service Broker 佇列接收相依變更通知。 |
| Start(String) |
啟動監聽器，接收由 連接字串 指定的 SQL Server 實例的相依變更通知。 |
| Stop(String, String) |
停止先前通話中 Start 指定的連線的監聽器。 |
| Stop(String) |
停止先前通話中 Start 指定的連線的監聽器。 |
| ToString() |
傳回表示目前 物件的字串。 (繼承來源 Object) |
事件
| 名稱 | Description |
|---|---|
| OnChange |
當收到與此 SqlDependency 物件相關的任何指令的通知時，會發生。 |