クエリーの作成

クエリーの作成には、少なくとも 3 つの別個のオブジェクト (QueryDef オブジェクトQueryFilterNode オブジェクト、および ResultSet オブジェクト) の作成が必要になります。 また、より複雑なクエリーの場合は、追加の QueryFilterNode オブジェクトの作成が必要になることもあります。

クエリーを作成するには、次のステップに従います。

  1. QueryDef オブジェクトを作成して、そのオブジェクトに検索パラメータを表示します。

    このオブジェクトを作成するには、Session オブジェクトの BuildQuery メソッドを使用します。

    注: クエリーの ビルドには、BuildSQLQuery メソッドではなく BuildQuery メソッドを 使用します。 BuildSQLQuery メソッドは、SQL クエリー文字列から直接 ResultSet オブジェクトを生成します。
  2. QueryDef のメソッドを使用して、検索条件を追加し、クエリーが戻す各レコードのフィールドを指定します。
  3. ResultSet オブジェクトを作成して、戻されたデータを保持します。

    このオブジェクトを作成するには、Session オブジェクトの BuildResultSet メソッドを呼び出します。作成時、ResultSet オブジェクトは、QueryDef オブジェクトの情報を使用した一連の内部データ構造をテンプレートとして作成します。クエリーを実行すると、ResultSet オブジェクトはこれらのデータ構造にクエリーからのデータを表示します。

  4. ResultSet オブジェクトの Execute メソッドを呼び出して、クエリーを実行します。
  5. このオブジェクトのほかのメソッドを使用して、データにアクセスします。(詳しくは、「結果セット内のナビゲート」を参照してください。)
注: BuildSQLQuery メソッドを使用して SQL 構文に基づいたクエリーを作成する場合は、必要なすべての検索パラメータがクエリー文字列になければなりません。BuildSQLQuery メソッドは、QueryDef オブジェクトを戻さずに、直接 ResultSet オブジェクトを戻します。

フィードバック