Reports for WPF
Subreport プロパティ (Field)
使用例 

C1.C1Report.4 アセンブリ > C1.C1Report 名前空間 > Field クラス : Subreport プロパティ
フィールド内にレンダリングされる別のレポート(サブレポート)への参照を取得または設定します。
シンタックス
'宣言
 
Public Property Subreport As C1Report
public C1Report Subreport {get; set;}
解説

サブレポートは、別のレポートに挿入されるレポートです。サブレポートは、いくつかのレポートを1つのレポートにまとめる場合に便利です。たとえば、いくつかのサブレポートを1つのレポートに組み込んだメインレポートを作成できます。また、メインレポートを使って詳細情報を表示し、サブレポートを使って各グループの先頭にサマリーデータを表示できます。

実用的な例として、コントロールに付属する NWIND.XML サンプルの "Sales By Category" レポートや "Sales By Year" レポートを参照してください。

フィールドをサブレポートとして定義するには、フィールドの Field.Subreport プロパティにサブレポートコントロールを割り当てます。

次に、サブレポートフィールドの Field.Text プロパティ(これは、Microsoft Access サブレポートの LinkChildFields/LinkMasterFields プロパティの設定と同じ)を使用して、サブレポートをメインレポートにリンクします。サブレポートフィールドの Text プロパティは、フィルタとして使用されます。このプロパティは、メインレポートの現在のレコードに基づいて、サブレポートのレンダリングに使用されるソースレコードセット内のレコードを指定します。

メインレポートがレンダリングされ、サブレポートフィールドに達すると、Text 式が評価され、その結果がサブレポートのフィルタ条件として使用されます。

リンク式の作成は難しくありませんが、引用符を含む文字列を作成する際に、これらの内部の引用符を二重("")にする必要があるため、多少複雑になります。

レポートデザイナを使ってレポートを作成する場合、コードでリンク式を作成する必要はありません。代わりに、サブレポートフィールドを右クリックし、[Link Subreport]メニューを選択します。ダイアログボックスが表示されるので、ここでマスターフィールドと詳細フィールドを選択できます。[OK]をクリックすると、レポートデザイナによって自動的にリンク式が作成され、サブレポートフィールドの Text プロパティに割り当てられます。

サブレポートフィールドの Field.CanGrow プロパティは、通常、true に設定されます。これにより、すべてのレコードを表示できるようにサブレポートフィールドを広げることができます。

サブレポートに別のサブレポートを入れることもできます。ネストできるレポートの深さに決めれた制限はありません。ただし、レポートの循環参照は指定できません。つまり、レポートはサブレポートを介して自分自身を参照することはできません。

使用例
// サブレポートをロードし、それをメインレポートのフィールドに割り当てます
string sSub = "Sales By Category Subreport";
c1Sub.Load("NWIND.XML", sSub);
c1rMain.Fields[sSub].Subreport = c1Sub;

// メインレポートとサブレポートの接続を設定します
c1rMain.Fields[sSub].Calculated = true;
c1rMain.Fields[sSub].Text = "\"CategoryName = '\" & [CategoryName] & \"'\"";
参照

Field クラス
Field メンバ