適用先: Access 2013、Office 2013
新しい QueryDef オブジェクトを作成します。
構文
式 。CreateQueryDef(Name, SQLText)
式Connection オブジェクトを表す変数です。
パラメーター
名前 |
必須かどうか |
データ型 |
説明 |
|---|---|---|---|
名前 |
省略可能 |
Variant |
新しい QueryDef の一意の名前を表す、サブタイプが文字列型 (String) であるバリアント型 (Variant) の値。 |
SQLText |
省略可能 |
Variant |
QueryDef を定義する SQL ステートメントである Variant (String サブタイプ)。 この引数を省略した場合、コレクションへの追加前または追加後に、 SQL プロパティを設定して、 QueryDef を定義できます。 |
戻り値
QueryDef
注釈
Microsoft Access ワークスペースでは、QueryDef の作成時に名前として長さ 0 の文字列以外を指定すると、作成された QueryDef オブジェクトが QueryDefs コレクションに自動的に追加されます。
名前で指定されたオブジェクトが既に QueryDefs コレクションのメンバーである場合は、実行時エラーが発生します。 CreateQueryDef メソッドを実行すると、名前の引数に長さ 0 の文字列を使用して一時的な QueryDef を作成できます。 新しく作成した QueryDef の Name プロパティを長さ 0 の文字列 ("") に設定することにより、これを行うこともできます。 一時的な QueryDef オブジェクトは、QueryDefs コレクション内に新しい永続的オブジェクトを作成せずに動的 SQL ステートメントを繰り返し使用する場合に便利です。 長さ 0 の文字列は永続的な QueryDef オブジェクトの有効な名前ではないので、一時的な QueryDef をコレクションに追加することはできません。 新しく作成した QueryDef オブジェクトの Name プロパティと SQL プロパティはいつでも設定が可能であり、設定後に QueryDef を QueryDefs コレクションに追加できます。
QueryDef オブジェクトで SQL ステートメントを実行するには、Execute メソッドまたは OpenRecordset メソッドを使用します。
ODBC データベースを使用して SQL パススルー クエリを実行する場合は、QueryDef オブジェクトの使用をお勧めします。
Microsoft Access データベース エンジンのデータベースで QueryDefs コレクションから QueryDef オブジェクトを削除するには、コレクションの Delete メソッドを使用します。