DetailBand.KeepTogetherWithDetailReports Property

Specifies whether the current Detail band should always be printed on the same page as its child DetailReport band.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v24.2.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

C#

[DefaultValue(false)]
[SRCategory(ReportStringId.CatBehavior)]
public bool KeepTogetherWithDetailReports { get; set; }

VB.NET

<DefaultValue(False)>
<SRCategory(ReportStringId.CatBehavior)>
Public Property KeepTogetherWithDetailReports As Boolean

Property Value

Type	Default	Description
Boolean	false	True to start printing the Detail band and its child DetailReport band at the top of the next page if their content does not fit the current page; false to print as much of the content as possible on the current page and print the rest on the next page.

Remarks

When a page break occurs while the Detail band and its child DetailReport band are being printed, the report continues printing the content on the next page. If the KeepTogetherWithDetailReports property is set to true, the report starts printing the Detail band on the top of the next page, and you can print the Detail bands all on one page. If a band content is longer than one page, the report continues printing on the following page.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the KeepTogetherWithDetailReports property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

reporting-wpf-create-report-in-code/CS/RuntimeReportsApplication/MainWindow.xaml.cs#L100

detailBand.Height = labelDetail.Height;
detailBand.KeepTogetherWithDetailReports = true;
report.Bands.Add(detailBand);

reporting-winforms-sql-data-source-runtime/CS/RuntimeSqlDataSourceReportSample/ReportCreator.cs#L65

detailBand.Height = labelDetail.Height;
detailBand.KeepTogetherWithDetailReports = true;
report.Bands.Add(detailBand);

VB.NET

reporting-wpf-create-report-in-code/VB/RuntimeReportsApplication/MainWindow.xaml.vb#L110

detailBand.Height = labelDetail.Height
detailBand.KeepTogetherWithDetailReports = True
report.Bands.Add(detailBand)

reporting-winforms-sql-data-source-runtime/VB/RuntimeSqlDataSourceReportSample/ReportCreator.vb#L62

detailBand.Height = labelDetail.Height
detailBand.KeepTogetherWithDetailReports = True
report.Bands.Add(detailBand)