未加工の SQL 文字列を使用して ResultSet オブジェクトを作成し、戻します。
BuildQuery メソッドは、SQL クエリー文字列を作成して、それを BuildSQLQuery メソッドで使用するのとは対照的に、クエリーとフィルタを定義する場合に使用します。
BuildResultSet と同様に、このメソッドは、クエリーの実行に使用できる ResultSet オブジェクトを作成します。BuildResultSet とは異なり、このメソッドは QueryDef オブジェクトの代わりに未加工の SQL 文字列を使用して、ResultSet オブジェクトのデータ構造をビルドします。SQL クエリー文字列を完全に構成するまで、このメソッドを呼び出さないでください。
BuildResultSet と同様に、このメソッドはクエリー データの保存に必要なデータ構造を生成しますが、データは取り込みません。クエリーを実行して結果のデータを取り込むには、ResultSet オブジェクトの Execute メソッドを呼び出す必要があります。
BuildResultSet とは異なり、BuildSQLQuery は QueryDef オブジェクトを使用しないので、ResultSet を構成する前は、SQL 文字列で定義されたクエリーは操作できません。
VBScript
session.BuildSQLQuery(SQL_string)
Perl
$session->BuildSQLQuery(SQL_string);
VBScript
set sessionObj = GetSession
' Create a SQL string to find all records and display their
' ID and headline fields
sqlString = "select T1.id,T1.headline from defect T1 where
T1.dbid <> 0"
set resultSetObj = sessionObj.BuildSQLQuery(sqlString)
Perl
$sessionobj = $entity->GetSession();
# Create a SQL string to find all records and display their
# ID and headline fields
$sqlString = "select T1.id,T1.headline from defect T1 where
T1.dbid <> 0";
$resultSetObj = $sessionobj->BuildSQLQuery($sqlString);