GrapeCity ActiveReports for .NET 16.0J
SubReport
ActiveReportsユーザーガイド > 概念 > ページレポート/RDLレポートの概念 > ページレポート/RDLレポートのレポートコントロール > SubReport

SubReportコントロールは、別のレポートのデータを表示するためのプレイスホルダーです。ActiveReportsでは、パフォーマンスを向上させるため、可能な限りSubReportコントロールではなくデータ領域を使用することをお勧めします。その理由は、レポートサーバーは各サブレポートのすべてのインスタンスを処理しなければならないため、サブレポートが多数含まれる大きなレポートではサブレポートがレポートごとに何度も処理されて負荷が非常に高くなる可能性があるためです。データ領域を使用して別々のデータグループを表示すれば、そのようなレポートの効率がはるかに向上します。詳細については、「レポートコントロールの操作」を参照してください。

メモ

有効なメインとサブのレポート形式の関係は以下の通りです。

メインレポートの形式 サブレポートに指定できる形式
セクションレポート セクションレポート
ページレポート RDLレポート
RDLレポート ページレポート、RDLレポート

サブレポートは、1つのデータ領域の中に異なるデータソースからのデータのグループを入れ子にする場合や、ある特定のサブレポートを複数のレポートで再利用する場合に役立ちます。サブレポートをデザインする際は、以下の点に注意が必要です。

パラメータ

親レポートに含まれるパラメータを使用して、サブレポートに表示するデータをフィルタリングすることができます。また、データ領域に入れ子になった反復するサブレポートにパラメータを渡して各インスタンスをフィルタリングすることもできます。

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

SubReportレポートコントロールのプロパティは、プロパティ設定ダイアログで設定することができます。このダイアログを開くには、レポート上のSubReportコントロールを選択し、[プロパティ]ウィンドウの[プロパティ設定ダイアログ]リンクをクリックします。表示される[SubReport]ダイアログが、SubReportコントロールのプロパティ設定ダイアログにあたります。

[SubReport]ダイアログでは、以下の各ページを使用してSubReportコントロールのプロパティを設定することができます。

メモ: プロパティの多くに用意されている<式...>オプションをクリックすると、[式エディタ]ダイアログが表示されます。このダイアログでは、値を決定する式を作成することができます。

全般

[名前]: まだレポートに使用されていない一意のサブレポートの名前を入力します。この名前はコードから呼び出すことができます。

[ツールヒント]: HTMLレポートでTITLE属性やALT属性を表示するために使用されるレポートアイテムのテキストラベル。

[サブレポート]:
[ファイルから開く]オプションを選択して[サブレポートを開く]ダイアログを開き、SubReportコントロール内に表示するレポートを選択します。

[このレポートのテーマをサブレポートに適用する]: このチェックボックスをオンにすると、サブレポートに親レポートと同じテーマが自動的に適用されます。

表示

[レポートの初期実行時]

[次のレポートアイテムでの表示の切り替えを可能にする]: このチェックボックスは、別のレポートコントロールの横にトグル画像を表示する場合にオンにします。ドロップダウンボックスが有効になり、クリックしたときにサブレポートの表示/非表示を切り替えるTextBoxコントロールを指定できます。

ナビゲーション

[見出しマップラベル]: 目次(見出しマップ)でこの項目を表すラベルとして使用する式を入力します。

[ブックマークID]: このサブレポートの位置を示すIDを入力します。[ブックマークに移動]アクションと組み合わせて使用することにより、別のレポートコントロールからこの項目にリンクできます。

パラメータ

[パラメータ]ページでは、新しいパラメータの入力のほか、[削除](X)ボタンを使用してパラメータの削除、矢印ボタンを使用してパラメータの順序の変更を行うことができます。リストにはパラメータごとに[パラメータ名][パラメータ値]があります。

[パラメータ名]は、ターゲットレポートに存在するパラメータの名前と正確に一致する必要があります。

[パラメータ値]には、サマリーまたはメインレポートからサブレポートターゲットへの情報の送信に使用する式を入力します。

データ出力

[要素名]: このサブレポートのXML出力で使用する名前を入力します。

[出力]: [自動][はい][いいえ]の値から選択して、このサブレポートをXML出力に含めるかどうかを指定します。[自動]を選択すると、サブレポートの内容がエクスポートされます。

関連トピック