すべて展開
すべて折りたたむSubReportコントロールは、別のレポートのデータを表示するためのプレイスホルダーです。ActiveReportsでは、パフォーマンスを向上させるため、可能な限りSubReportコントロールではなくデータ領域を使用することをお勧めします。その理由は、レポートサーバーは各サブレポートのすべてのインスタンスを処理しなければならないため、サブレポートが多数含まれる大きなレポートではサブレポートがレポートごとに何度も処理されて負荷が非常に高くなる可能性があるためです。データ領域を使用して別々のデータグループを表示すれば、そのようなレポートの効率がはるかに向上します。詳細については、「レポートコントロールとデータ領域の操作」を参照してください。
 |
メモ: SubReportコントロールはページレポートではサポートされていません。使用可能なレポートはRDLレポートのみです。また、RDLレポート内のSubReportのターゲットとしてセクションレポートを使用することはできません。その逆も同様です。 |
サブレポートは、1つのデータ領域の中に異なるデータソースからのデータのグループを入れ子にする場合や、ある特定のサブレポートを複数のレポートで再利用する場合に役立ちます。サブレポートをデザインする際は、以下の点に注意が必要です。
- メインレポートに変更を加えずにサブレポートだけを変更した場合は、［更新］ボタンをクリックして［プレビュー］タブでサブレポートを再実行します。
- スタンドアロンのレポートデザイナアプリケーションで親レポートを設計する場合は、［プレビュー］タブでサブレポートを描画できるように、親レポートをサブレポートと同じディレクトリに保存します。
- SubReportコントロールとそこでホストされるレポートのボディに罫線を設定した場合、それら2つの罫線はマージされません。
- SubReportコントロールでホストされるレポートが見つからない場合、またはそのレポートに行が含まれない場合は、SubReportコントロールの罫線のみが描画されます。
- ホストされたレポートに行が含まれる場合は、ホストされたレポートのボディの罫線が描画されます。
パラメータ
親レポートに含まれるパラメータを使用して、サブレポートに表示するデータをフィルタリングすることができます。また、データ領域に入れ子になった反復するサブレポートにパラメータを渡して各インスタンスをフィルタリングすることもできます。
プロパティ設定ダイアログ
SubReportレポートコントロールのプロパティは、プロパティ設定ダイアログで設定することができます。このダイアログを開くには、レポート上のSubReportコントロールを選択し、［プロパティ］ウィンドウの［プロパティ設定ダイアログ］リンクをクリックします。表示される［SubReport］ダイアログが、SubReportコントロールのプロパティ設定ダイアログにあたります。
［SubReport］ダイアログでは、以下の各ページを使用してSubReportコントロールのプロパティを設定することができます。
|
メモ: プロパティの多くに用意されている<式...>オプションをクリックすると、［式エディタ］ダイアログが表示されます。このダイアログでは、値を決定する式を作成することができます。 |
全般
［名前］: まだレポートに使用されていない一意のサブレポートの名前を入力します。この名前はコードから呼び出すことができます。
［ツールヒント］: 実行時にユーザーがビューワ内のサブレポート上でポインタををホバーさせた際に表示する値、または式を入力します。
［サブレポート］:
［ファイルから開く］オプションを選択して［サブレポートを開く］ダイアログを開き、SubReportコントロール内に表示するレポートを選択します。
［サーバーから開く］オプションを選択して［サーバーから開く］ダイアログを開き、SubReportコントロール内に表示するActiveReports Server上にあるレポートを選択します。
［このレポートのテーマをサブレポートに適用する］: このチェックボックスをオンにすると、サブレポートに親レポートと同じテーマが自動的に適用されます。
表示
［レポートの初期実行時］
- ［表示する］: レポートを実行したときにサブレポートが表示されます。
- ［非表示］: レポートを実行したときにサブレポートは表示されません。
- ［式］: サブレポートを表示するかどうかを決定するブール値に評価される式を使用します。「True」の場合は非表示になり、「False」の場合は表示されます。
［次のレポートアイテムでの表示の切り替えを可能にする］: このチェックボックスは、別のレポートコントロールの横にトグル画像を表示する場合にオンにします。ドロップダウンボックスが有効になり、クリックしたときにサブレポートの表示／非表示を切り替えるTextBoxコントロールを指定できます。
ナビゲーション
［見出しマップラベル］: 目次（見出しマップ）でこの項目を表すラベルとして使用する式を入力します。
［ブックマークID］: このサブレポートの位置を示すIDを入力します。［ブックマークに移動］アクションと組み合わせて使用することにより、別のレポートコントロールからこの項目にリンクできます。
パラメータ
［パラメータ］ページでは、新しいパラメータの入力のほか、［削除］（X）ボタンを使用してパラメータの削除、矢印ボタンを使用してパラメータの順序の変更を行うことができます。リストにはパラメータごとに［パラメータ名］と［パラメータ値］があります。
各［パラメータ名］は、ターゲットレポートに存在するパラメータの名前と正確に一致する必要があります。
［パラメータ値］には、サマリーまたはメインレポートからサブレポートターゲットへの情報の送信に使用する式を入力します。
データ出力
［要素名］: このサブレポートのXML出力で使用する名前を入力します。
［出力］: ［自動］、［はい］、［いいえ］の値から選択して、このサブレポートをXML出力に含めるかどうかを指定します。［自動］を選択すると、サブレポートの内容がエクスポートされます。