When rendering a report there is a definite order in which the bands are generated because every band has specific functionality. For example, for a table output you should use three bands: Header, Data, Footer. The Header band is used to place column headers, the Data values are placed on the Data band, and the totals are placed on the Footer band.
The following table describes the bands and their output order:
|
Order |
Name |
Description |
|
1 |
PageHeaderBand |
On each page. Output on the first page is optional. |
|
2 |
ReportTitleBand |
Once at the beginning of a report. The ReportTitleBand can be output before the PageHeaderBand if the TitleBeforeHeader property of the page on which both bands are placed is set to true. |
|
3 |
HeaderBand, ColumnHeader |
Once before data output (for the ColumnHeader - once for every column). Output on each new page is optional. |
|
4 |
GroupHeaderBand |
At the beginning of each group. Output on each new page is optional. |
|
5 |
DataBand |
Once for every row of data. |
|
6 |
GroupFooterBand |
At the end of each group. |
|
7 |
FooterBand, ColumnFooter |
After all data has been output (for the ColumnFooter - once for every column). Output on each new page is optional. |
|
8 |
ReportSummaryBand |
Once at the end of a report. |
|
9 |
PageFooterBand |
On every page. Output on first page is optional. |
The Child band is not specified in the preceding table. This band is always printed immediately after the band it follows when placed on a page.
Note:
Components placed directly
on the page (i.e. not on any band) are printed first, followed by
the bands.
In a report it is possible to use as many bands of one type as you wish. For example, you can use two Header bands.
If there is more than one band of one type then they will be output in the order of their position on a page. In other words the band furthest up the page will be printed first followed by the other bands of the same type. This is also true with cross-bands except that the band on the left will be printed first.
The order
in which bands of the same type are output can be changed by simply
moving the bands on the page. You can drag one of the bands with
the mouse or you can use the Move Forward and Move Backward
commands from the context (right click) menu or you can use
the
buttons on the Layout toolbar to
change the band order.