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 オブジェクトを 1 つ以上の SqlCommand オブジェクトに関連付ける必要があります。 通知を受信するには、 OnChange イベントをサブスクライブする必要があります。 通知のクエリを作成するための要件の詳細については、「 クエリ通知の操作」を参照してください。
Note
SqlDependency は、データベースに対してアクティブな依存関係を持つサーバーの数が比較的少ない ASP.NET または中間層サービスで使用するように設計されています。 これは、数百または数千のクライアント コンピューターが 1 つのデータベース サーバーに対して SqlDependency オブジェクトを設定するクライアント アプリケーションで使用するようには設計されていません。 データ変更時に、信頼できる即時の通知が必要なアプリケーションを開発している場合は、「通知の計画」記事の「効率的なクエリ通知方法の計画」および「クエリ通知に代わる方法」を参照してください。
詳細については、「Query Notifications in SQL Server」および>「Building Notification Solutions」を参照してください。
Note
OnChange イベントは、コマンドの実行を開始したスレッドとは異なるスレッドで生成される場合があります。
クエリ通知は、特定の要件を満たす SELECT ステートメントでのみサポートされます。
コンストラクター
| 名前 | 説明 |
|---|---|
| SqlDependency() |
既定の設定を使用して、 SqlDependency クラスの新しいインスタンスを作成します。 |
| SqlDependency(SqlCommand, String, Int32) |
SqlDependency クラスの新しいインスタンスを作成し、SqlCommand パラメーターに関連付け、通知オプションとタイムアウト値を指定します。 |
| SqlDependency(SqlCommand) |
SqlDependency クラスの新しいインスタンスを作成し、SqlCommand パラメーターに関連付けます。 |
プロパティ
| 名前 | 説明 |
|---|---|
| HasChanges |
依存関係に関連付けられている結果セットのいずれかが変更されたかどうかを示す値を取得します。 |
| Id |
SqlDependency クラスのこのインスタンスを一意に識別する値を取得します。 |
メソッド
| 名前 | 説明 |
|---|---|
| AddCommandDependency(SqlCommand) |
SqlCommand オブジェクトをこのSqlDependency インスタンスに関連付けます。 |
| Equals(Object) |
指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| Start(String, String) |
指定した SQL Server Service Broker キューを使用して、接続文字列によって指定されたSQL Serverのインスタンスから依存関係変更通知を受信するためのリスナーを開始します。 |
| Start(String) |
接続文字列で指定されたSQL Serverのインスタンスから依存関係変更通知を受信するためのリスナーを開始します。 |
| Stop(String, String) |
前の Start 呼び出しで指定された接続のリスナーを停止します。 |
| Stop(String) |
前の Start 呼び出しで指定された接続のリスナーを停止します。 |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
イベント
| 名前 | 説明 |
|---|---|
| OnChange |
この SqlDependency オブジェクトに関連付けられているコマンドの通知を受信したときに発生します。 |