PARAMETERS 宣言

パラメータ クエリの中で使用する各パラメータの名前とデータ型を宣言します。

構文

PARAMETERS name datatype [, name datatype [, ...]]

PARAMETERS 宣言には、次の指定項目があります。

指定項目 内容
name パラメータ名。Parameter オブジェクトの Name プロパティに割り当てられ、Parameters コレクションの中でパラメータを識別するために使用します。引数 name は、アプリケーションでクエリを実行した場合に表示されるダイアログ ボックスの文字列として使用されます。スペースおよび記号を含む文字列は角かっこ ([ ]) で囲みます。たとえば、[バーゲン プライス] や [何月からのレポートを作成しますか ?] などと指定します。
datatype Microsoft Jet SQL データ型の 1 つ、またはその別名のうちの 1 つを指定します。

解説

定期的に実行するクエリは、PARAMETERS 宣言を使用してパラメータ クエリにすると便利です。パラメータ クエリを使用すると、クエリの抽出条件の変更作業を自動化できます。パラメータ クエリでは、クエリを実行するたびにコードからパラメータを指定する必要があります。

PARAMETERS 宣言は省略可能ですが、指定する場合は SELECT ステートメントなどのほかのステートメントよりも前に記述します。

この宣言で複数のパラメータを指定する場合は、パラメータとパラメータの間をカンマで区切ります。次の例では、パラメータを 2 つ指定しています。

PARAMETERS [バーゲン プライス] Currency, 開始日 DateTime;

    

WHERE 句および HAVING 句では、引数 name は使用できますが引数 datatype は使用できません。次の例では、ユーザーに 2 つのパラメータの入力を求め、取得した抽出条件を [注文] テーブルのレコードに適用します。

PARAMETERS [バーゲン プライス] Currency,

開始日 DateTime;

SELECT 伝票番号, 合計金額

FROM 注文

WHERE 合計金額 > [バーゲン プライス]

AND 注文日 >= 開始日;

    

参照
EXECUTE ステートメント (Microsoft Jet SQL) SELECT ステートメント (Microsoft Jet SQL)
HAVING 句 (Microsoft Jet SQL) WHERE 句 (Microsoft Jet SQL)
SQL データ型  

使用例

PARAMETERS 宣言の使用例