［レポート－パラメータ］ダイアログにアクセスする

以下のいずれかの方法で［レポート－パラメータ］ダイアログにアクセスすることができます。

• ［レポートエクスプローラ］で、［追加］（＋）アイコンをクリックし、［パラメータ］オプションを選択します。
• ［レポートエクスプローラ］で、［パラメータ］ノード右クリックし、［パラメータの追加］を選択します。
• ［レポートエクスプローラ］で、［レポート］ノードを右クリックして[レポートパラメータ]を選択します。
• ［レポート］メニューから、[レポートパラメータ]を選択します。

［レポート－パラメータ］ダイアログには、［パラメータ］ページがあります。このページには、パラメータ一覧と、パラメータプロパティを設定するための３つのタブ（［全般］、［使用できる値］、［既定値］）が含まれています。パラメータを一覧に追加するには、［追加］（＋）アイコンをクリックし、３つのタブでパラメータのプロパティを設定します。タブの詳細については後述します。

［レポート－パラメータ］ダイアログでは、各パラメータに対してパラメータ入力ダイアログの表示を制御することができます。同ダイアログで以下のプロパティを設定してパラメータを作成します。

• レポートのパラメータ名を入力します。コレクションの各パラメータ名は一意の名前である必要があり、［データセット］ダイアログのパラメータ名と同じ名前である必要があります。上記の例では、名前は「MPAA」になります。
• データタイプ、パラメータ入力ダイアログのテキスト、Null値、空白、複数の値のデータ、複数行表示を許可するか、パラメータ入力ダイアログを非表示にするかを設定します。
• 既定値を設定、またはユーザーが使用できる値の一覧を作成します。

パラメータは、レポートパラメータコレクション内で表示されている順番で取得されます。表示順は［レポート－パラメータ］ダイアログから矢印のアイコンを使用して変更することができます。

［全般］

［使用できる値］

［既定値］

［データセット］ダイアログの［パラメータ］ページで、クエリのパラメータにレポートのパラメータを渡します。パラメータ一覧の一番上の［追加］（＋）アイコンをクリックし、パラメータ名を入力し、以下のような値を入力します。

=Parameters!MPAA.Value

［データセット］ダイアログの［クエリ］ページで、SQLクエリにパラメータを入力します。パラメータを作成するには、データソースに特有の構文を使用します。たとえば、OleDBデータソースの場合、以下のようなクエリを入力します。

SELECT * FROM Movie WHERE (MPAA = ? AND YearReleased = ?)
       

パラメータ値をユーザーに入力してもらうには、以下の設定が完了している必要があります。

• 少なくとも１つのパラメータがレポートのパラメータコレクションに存在する。
• 少なくとも１つのパラメータのPromptUserプロパティが「True」に設定されている。
• レポートオブジェクトでは、ShowParameterUIプロパティが「True」に設定されている。

コレクションにパラメータが存在し、ShowParameterUIプロパティが「True」に設定されている場合、レポートを実行すると自動的にパラメータ入力ダイアログが表示されます。要求される値をユーザーが入力して［OK］ボタンをクリックすると、レポートが入力値を使用して表示されます。

［レポートエクスプローラ］から追加されたパラメータ値は、SQLクエリのパラメータに「param:」というパラメータプレフィックスを指定して適用することができます。このプレフィックスは、SQLパラメータをレポートエクスプローラのパラメータと関連付けます。

例　select * from CUSTOMERS where CustomerName = '<%param:Parameter1%>'

この例の場合、SQLクエリ内にparam:というプレフィックスを持つパラメータが、［レポートエクスプローラ］上の該当するパラメータ値で更新されます。

SQLクエリの実行時にパラメータを追加する場合、クエリは以下のようになります。

または

［レポートデータソース］ダイアログ内のボタンをクリックして［クエリデザイナ］を開き、パラメータ付きクエリを作成することも可能です。［クエリデザイナ］を使用して対話的にクエリを作成する方法の詳細については、「クエリデザイナでクエリの作成」を参照してください。

パラメータの構文にパイプ区切りで５つの値を指定します。

<%Name | PromptString | DefaultValue | DataType | PromptUser%>

最初の値（Name）が必須となりますが、３番目の値（DefaultValue）を指定しない場合、フィールド一覧はデザイン時に埋め込まれません。Name値のみを指定し、パイプなしで渡すこともできます。いくつかの値を指定する場合、パイプを追加しますが、指定しない値に対して空白を指定する必要はありません。

例　<%ProductID||||False%>

Name: パラメータの一意の名前で、コードで入力されたパラメータのKeyプロパティに該当します。
PromptString: パラメータ入力ダイアログに表示する文字列で、ユーザーに入力してほしいデータに関する情報を表示します。
DefaultValue: パラメータのデフォルト値を設定します。たとえば、日付パラメータの場合、フィールドのデフォルト値を現在の日付にしておくと、別の日付に基づくレポートを生成する場合を除いて、［Enter］キーを押すだけで設定が済みます。
DataType: 既定値がS（文字列）で、この値はパラメータが示すデータ型をActiveReportsに通知します。ユーザープロンプトで使用されるコントロールの種類についても決定されます。タイプは以下の３つから選択することができます。

• S (文字列)は、ユーザーが文字列を入力できるテキストボックスを提供します。
  データソースによっては、文字列値の場合はパラメータ構文を一重引用符（'）、または二重引用符（"）で挟んで表記する必要があります。
  例　'<%MyStringParameter%>'
  また、文字列パラメータ用の既定値を引用符（一重、または二重引用符）を使用して指定する場合、ActiveReportsはこの引用符付きで文字列をSQLクエリに転送します。
  例　<%MyStringParameter||"既定値"|S|False%>
• D (日付) は、ドロップダウン式のカレンダーピッカーを提供し、ユーザーがこのカレンダーから日付を選択することができます。
  データソースによっては、パラメータ構文の前後を番号符（#）で挟んで表記する必要があります。
  例　#<%日付パラメータ%>#
• B (ブール)は、ユーザーがON／OFFすることのできるチェックボックスを提供します。
  「True」か「False」、または「0」か「1」の既定値を指定した場合、ActiveReportsはSQLへ同じ形式で転送します。

PromptUser: パラメータ入力ダイアログを表示するかどうかを指定するブール値。いくつかのパラメータに対して「True」を設定し、いくつかには「False」を設定することができます。レポートでパラメータのPromptUserプロパティの値にかかわらず、レポートのShowParameterUIプロパティが「False」に設定されている場合、パラメータ入力ダイアログは表示されません。