AddRelatedQuery

説明

SetMasterQuery から返された外部キーに基づいて他のクエリを作成します。

戻り値の型

なし

構文

object.AddRelatedQuery ConnectionString, UserID, Password, Options, QueryString, MultiRows

AddRelatedQuery メソッドは次のパラメータから構成されています。

パラメータ	値の型	説明
Object		Toolkit オブジェクト
ConnectionString	String	データベース接続に使用する接続文字列。接続文字列は、ActiveX データオブジェクト (ADO) 2.5 定義に基づきます。すべての OLEDB プロバイダを使用できますが、デフォルトは ODBC です。接続文字列の例を次に示します。
UserID	String	接続に必要なユーザー ID (Microsoft Access データベースには、管理者権限のあるユーザー ID が必要です。その場合、パスワードは必要ありません。)
Password	String	接続に必要なパスワード
Options	Long	ここでは -1 を設定する必要があります
QueryString	String	実行する SQL クエリ文字列。マスタクエリがデータベースから結果を返します。関連するクエリがマスタクエリにより返された結果を使用して、その後のクエリ (フィルター) を行います。
MultiRows	Long	一対多 (1 : N) リレーションシップのクエリか否かを示します

Connection Strings

接続文字列の一般的な例を次に示します

接続文字列	例
DSN の使用	"DSN=MyDatabase;"
ODBC を使用した Microsoft Access	Driver"DBQ=C:\InetPub\database\donations.mdb;Driver={Microsoft Access Driver(*.mdb)};"
Access OLEDB ドライバを使用した Microsoft Access	"Provider=Microsoft.Jet.OLEDB.4.0;Data Source C:\InetPub\database\donations.mdb;"
ODBC ドライバを使用した SQL サーバー	"Driver={SQL Server};Server=activePDF;Database= pubs;Uid=sa; Pwd=;"
OLEDB ドライバを使用した SQL サーバー	"PROVIDER=SQLOLEDB;DATA SOURCE=ServerName;DATABASE= pubs;USER ID=sa;PASSWORD=;"

備考

マスタクエリと関連付けるには、置換する変数をパイプ文字 ("|") で囲む、または置換するフィールド名を使用して RelatedQuerySeparator で指定した文字で囲む必要があります。たとえばマスタクエリが発注テーブルからオーダーを選択し、関連付けるクエリが発注テーブルからオーダーの詳細を参照する場合は、次のように記述します。

Select * from OrderDetails where OrderId='|OrderID|'

注意 : ClearQueries を呼び出し、クエリをキャンセルできます。

例

Public Sub ExampleCodeForAddRelatedQuery()

TK.AddRelatedQuery "DBQ=C:\InetPub\database\donations.mdb;Driver={Microsoft Access Driver (*.mdb)};", "admin", "", -1, "Select * from OrderDetails where OrderID='|OrderID|'"

End Sub