ActiveReports 16 .NET Edition
ActiveReports 16 User Guide / Concepts / Page Report/RDL Report Concepts / Layout / Page Breaks in Data Regions
In This Topic
    Page Breaks in Data Regions
    In This Topic

    You can control page breaks in data groups of data regions by using the NewPage property for data regions and its combination with the PageBreakAtStart, PageBreakAtEnd, and BreakLocation properties. These properties help you tune page breaks after or before a data group in your report, and specify the page to continue displaying the report content.

    The NewPage property works for the data regions - List, Table, BandedList, Tablix, Container, TOC, and Chart, and has the following options.

    You can use the NewPage property for the following data region groups:

    NewPage and PageBreakAtStart / PageBreakAtEnd

    See the possible combinations of NewPage with the PageBreakAtStart and PageBreakAtEnd properties. 

    PageBreakAtStart PageBreaktEnd NewPage > Next NewPage > Odd NewPage > Even
    False False No new page No new page No new page
    False True A new page is added after the data region. A new page is added after the data region and at odd page of the report. A new page is added after the data region and at even page of the report.
    True False A new page is added before the data region. A new page is added before the data region and at odd page of the report. A new page is added before the data region and at even page of the report.
    True True A new page is added before and  after the data region. A new page is added before and after the data region and at odd page of the report. A new page is added before and after the data region and at even page of the report.

     

    The image below uses a report that has a Table data region with the following properties:   

    As a result, the report renders 10 pages, a page break is added after a table, and a new page is added after the table at an even page (Page 10). 

    NewPage as Page Break 

    After the same properties are changed as

    As a result, the report renders 11 pages, a page break is added before a table (Page 2), and a new page is added at odd page of the report (Page 1).

    NewPage and BreakLocation 

    The BreakLocation property controls the break location of a data group. See the possible combination of the NewPage with the BreakLocation property.

    NewPage > Next NewPage > Odd NewPage > Even
    BreakLocation > None

    No page break

    BreakLocation > Start A page break is added before a new group. A new group starts from the next page of the report. A page break is added before a new group. A new group starts from the next odd page of the report. A page break is added before a new group. A new group starts from the next even page of the report.
    BreakLocation > End A page break is added after a current group. A new group starts from the next page of the report. 1 A page break is added after a current group. A new group starts from the next odd page of the report. 1 A page break is added before a new group. A new group starts from the next even page of the report. 1
    BreakLocation > StartAndEnd A page break is added before and after a current group. A new group starts from the next page of the report. A page break is added before and after a current group. A new group starts from the next odd page of the report. A page break is added before a new group. A new group starts from the next even page of the report.
    BreakLocation > Between A page break is between groups. A new group starts from the next page of the report. 1 A page break is between groups. A new group starts from the next odd page of the report. 1 A page break is added before a new group. A new group starts from the next even page of the report. 1

    1 The first group always starts on the first page. 

    Multiple Data Regions Behavior

    In a report with multiple data regions, the behavior of the NewPage property is as follows:

    Page Report Limitation: When multiple data regions are added to the same page, the data regions take the Next value; the other values (Odd, Even) are ignored.