このタスクについて
クエリーの作成には、少なくとも 3 つの別個のオブジェクト (QueryDef オブジェクト、QueryFilterNode
オブジェクト、および ResultSet オブジェクト) の作成が必要になります。
また、より複雑なクエリーの場合は、追加の QueryFilterNode オブジェクトの作成が必要になることもあります。
クエリーを作成するには、次のステップに従います。
- QueryDef オブジェクトを作成して、そのオブジェクトに検索パラメータを表示します。
このオブジェクトを作成するには、Session オブジェクトの BuildQuery メソッドを使用します。
- QueryDef のメソッドを使用して、検索条件を追加し、クエリーが戻す各レコードのフィールドを指定します。
- ResultSet オブジェクトを作成して、戻されたデータを保持します。
このオブジェクトを作成するには、Session オブジェクトの BuildResultSet メソッドを呼び出します。作成時、ResultSet オブジェクトは、QueryDef オブジェクトの情報を使用した一連の内部データ構造をテンプレートとして作成します。クエリーを実行すると、ResultSet オブジェクトはこれらのデータ構造にクエリーからのデータを表示します。
- ResultSet オブジェクトの Execute メソッドを呼び出して、クエリーを実行します。
- このオブジェクトのほかのメソッドを使用して、データにアクセスします。(詳しくは、「結果セット内のナビゲート」を参照してください。)
タスクの結果
注: BuildSQLQuery メソッドを使用して SQL 構文に基づいたクエリーを作成する場合は、必要なすべての検索パラメータがクエリー文字列になければなりません。BuildSQLQuery メソッドは、QueryDef オブジェクトを戻さずに、直接 ResultSet オブジェクトを戻します。