SqlDependency 類別

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

SqlDependency 物件表示應用程式與 SQL Server 執行個體之間的查詢告知相依性。 應用程式可以建立 SqlDependency 物件，並註冊為透過 OnChangeEventHandler 事件處理常式接收告知。

public ref class SqlDependency sealed

public sealed class SqlDependency

type SqlDependency = class

Public NotInheritable Class SqlDependency

繼承

Object

SqlDependency

備註

SqlDependency 適合用於快取案例，其中您的 ASP.NET 應用程式或仲介層服務需要將特定資訊保留在記憶體中。 SqlDependency 可讓您在資料庫中的原始資料變更時收到通知，以便重新整理快取。

若要設定相依性，您必須將 SqlDependency 物件與一或多個 SqlCommand 物件產生關聯。 若要接收通知，您必須訂閱 OnChange 事件。 如需建立通知查詢需求的詳細資訊，請參閱 使用查詢通知。

注意

SqlDependency 設計成用於 ASP.NET 或仲介層服務，其中有相對少量的伺服器具有對資料庫作用中的相依性。 它並非設計成在用戶端應用程式中使用，其中數百或數千部用戶端電腦會為 SqlDependency 單一資料庫伺服器設定物件。 如果您開發的應用程式資料在變更時需要可靠的次秒通知，請查看在規劃通知的高效規劃查詢通知策略和查詢通知替代方案的文章。

如需詳細資訊，請參閱SQL Server 中的查詢通知和建置通知解決方案。

注意

事件 OnChange 可能會在與起始命令執行的執行緒不同的執行緒上產生。

只有符合一組特定需求的 SELECT 陳述式才支援查詢通知。

建構函式

SqlDependency()	以預設設定建立 SqlDependency 類別的新執行個體。
SqlDependency(SqlCommand)	建立 SqlDependency 類別的新執行個體，並使它與 SqlCommand 參數產生關聯。
SqlDependency(SqlCommand, String, Int32)	建立 SqlDependency 類別的新執行個體、使它與 SqlCommand 參數產生關聯，並指定告知選項和逾時值。

屬性

HasChanges	取得值，指出與相依性相關的其中一個結果集是否已變更。
Id	取得值，唯一識別 SqlDependency 類別的這個執行個體。

方法

AddCommandDependency(SqlCommand)	使 SqlCommand 物件與這個 SqlDependency 執行個體產生關聯。
Start(String)	啟動接聽程式，從連接字串所指定的 SQL Server 執行個體接收相依性變更告知。
Start(String, String)	啟動接聽程式，從連接字串所指定的 SQL Server 執行個體並使用指定的 SQL Server Service Broker 佇列，接收相依性變更告知。
Stop(String)	停止在前一個 Start(String) 呼叫中指定之連接的接聽程式。
Stop(String, String)	停止在前一個 Start(String, String) 呼叫中指定之連接的接聽程式。

事件

OnChange

接收到與這個 SqlDependency 物件相關的任何命令之告知時發生。