セクションレポートのSubReportコントロールを使用して、レポートに任意の子レポートを組み込むことができます。レポートにサブレポートコントロールを配置して、ロードするレポートのインスタンスをコード内に作成し、レポートのオブジェクトをサブレポートに関連付けるコードを追加します。

さらに、親レポートからサブレポートにパラメータを渡して、親レポートに関連するデータをサブレポートの各インスタンスに表示することも可能です。

サブレポートを使用するケース

2つ目のレポートを実行して、それを1つ目のレポートに埋め込む処理には高いオーバーヘッドがあるので、このような場合には一般的にサブレポートを使用する方法が最適です。サブレポートは、以下のような場合に使用可能です。

複数のデータソースを使用する場合
複数のDetailセクションを使用する場合
グラフと表を並べて表示するレポートの場合

サブレポートではサポートされていないページ依存の要素

サブレポートは親レポートの中に描画されるため、印刷されたページの任意の要素から切り離されています。そのため、ページ依存の機能がサポートされていません。ページに依存する要素はすべて親レポート内に保持する必要があります。サブレポートでサポートされていないページ依存の要素を以下に示します。

ページ数
ページヘッダとフッタセクション（これらのセクションを消去することで、処理時間を節約することができます）
KeepTogetherプロパティ
GroupKeepTogetherプロパティ
NewPageプロパティ
RepeatToFillプロパティ

コーディングのベストプラクティス

親レポートのReportStartイベントを使用してSubReportコントロールのレポートのインスタンスを作成し、ReportEndイベント内で解放します。このように、親レポートを実行すると1つのサブレポートのインスタンスのみが作成されます。

当該セクションのFormatイベントで、サブレポートコントロールのReportプロパティを使用して、レポートオブジェクトをSubReportコントロールに関連付けます。

注意: Formatイベントでサブレポートを初期化することは推奨されません。これは、セクションが処理される度に、サブレポートの新しいインスタンスが作成されるためです。また、特に大量のデータを処理するレポートの場合はメモリと処理時間が多く消費されます。

主なプロパティ

プロパティ	解説
CanGrow	コントロールの内容に合わせて、コントロールの高さを拡大するかどうかを決定します。
CanShrink	フィールドの値に合わせて、フィールドの高さを縮小するかどうかを決定します。
CloseBorder	デフォルト設定では、コントロールの下部の罫線はサブレポートの末尾までは描画されません。このプロパティを「True」に設定すると、各ページの下部に描画します（コードでのみ使用可能）。
Report	コントロールにレポートオブジェクトを関連付けます（コードでのみ使用可能）。

プロパティ設定ダイアログ

SubReportコントロールの各プロパティは、プロパティ設定ダイアログで設定することができます。このダイアログを表示するには、レポート上のSubReportコントロールを選択した状態で、［プロパティ］ウィンドウの下部にあるコマンドから「プロパティ設定ダイアログ」のリンクをクリックします。表示される［SubReport］ダイアログが、SubReportコントロールのプロパティ設定ダイアログにあたります。
［SubReport］ダイアログでは、以下の各ページでSubReportコントロールのプロパティを設定することができます。

［全般］

［書式］

サブレポートを使用するケース

サブレポートではサポートされていないページ依存の要素

コーディングのベストプラクティス

プロパティ設定ダイアログ

［高さ］