SqlDependency 類別

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.SqlClient.dll

套件:

System.Data.SqlClient v4.8.6

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 可讓您在資料庫的原始數據變更時收到通知，以便重新整理快取。

若要設定相依性，您必須將物件與一或多個SqlCommand對象產生關聯SqlDependency。 若要接收通知，您必須訂閱 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 執行個體產生關聯。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Start(String)	啟動接聽程式，從連接字串所指定的 SQL Server 執行個體接收相依性變更告知。
Start(String, String)	啟動接聽程式，從連接字串所指定的 SQL Server 執行個體並使用指定的 SQL Server Service Broker 佇列，接收相依性變更告知。
Stop(String)	停止在前一個 Start 呼叫中指定之連接的接聽程式。
Stop(String, String)	停止在前一個 Start 呼叫中指定之連接的接聽程式。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

事件

OnChange

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

另請參閱

• 使用查詢通知
• ADO.NET 概觀 \(部分機器翻譯\)