データ処理拡張機能の Command クラスを実装する

  • [アーティクル]

Command オブジェクトを使用して、要求を作成し、それをデータ ソースに渡します。 コマンド テキストは、テキスト、XML など多くのさまざまな構文形式を使用できます。 結果が返されると、Command オブジェクトは、DataReader オブジェクトとして結果を返します。

Command クラスを作成するには、IDbCommand を実装します。 DataReader オブジェクトとして結果セットを返すには、ExecuteReader メソッドを実装します。 Command クラスの ExecuteReader メソッドには、引数として CommandBehavior 列挙を取得する実装を含める必要があります。 データ処理拡張機能をレポート デザイナーに配置するには、SchemaOnly メソッドで ExecuteReader の場合を処理する実装を含める必要があります。 スキーマだけの実装は、レポート デザイナーにフィールド一覧を提供するために使用します。 ExecuteReader メソッドによって返される DataReader オブジェクトは、フィールド、つまり、列の型および名前の情報を結果セットに含める必要があります。

必要に応じて、Command クラスは IDbCommandAnalysis を実装できます。 このインターフェイスにより、実装クラスでクエリを分析して、クエリのパラメーターの一覧を返すことができます。 IDbCommandAnalysis インターフェイスの機能を使用できるのはレポート デザイナーだけです。 IDbCommandAnalysis を実装すると、レポート デザイナーのユーザーがプレビュー モードでレポートを実行するたびに、ユーザーにパラメーターを入力するように要求できます。 さらに、 [データセット] ダイアログの [パラメーター] タブでパラメーターを表示できます。

注意

カスタム データ処理拡張機能でパラメーターをサポートしない場合は、IDbCommandAnalysis を実装する必要はありません。

Command クラス実装の例については、「SQL Server Reporting Services Product Samples」 (SQL Server Reporting Services 製品サンプル) を参照してください。

関連するコンテンツ