ReportPrintOptions.DetailCountOnEmptyDataSource Property

Specifies how many times the Detail band should be printed when no data source is defined for the report.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v18.2.dll

Declaration

C#

[DefaultValue(1)]
public int DetailCountOnEmptyDataSource { get; set; }

VB.NET

<DefaultValue(1)>
Public Property DetailCountOnEmptyDataSource As Integer

Property Value

Type	Default	Description
Int32	1	An integer value.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to DetailCountOnEmptyDataSource
WinForms Controls	XtraSchedulerReport	.ReportPrintOptions.DetailCountOnEmptyDataSource
Reporting	DetailReportBand	.ReportPrintOptions.DetailCountOnEmptyDataSource
	XtraReport	.ReportPrintOptions.DetailCountOnEmptyDataSource
	XtraReportBase	.ReportPrintOptions.DetailCountOnEmptyDataSource

Remarks

Use the DetailCountOnEmptyDataSource property, to specify how many times the Detail band is printed, when no data source is defined for the report.

To specify the number of times the Detail band is printed when a data source is defined for the report (and it is not empty), use the ReportPrintOptions.DetailCount property.

To limit the number of records shown when a report is previewed at design time, use the ReportPrintOptions.DetailCountAtDesignTime property.

To choose whether or not a report should be printed when its data source has no data, use the ReportPrintOptions.PrintOnEmptyDataSource property.

To learn more, see Data Filtering Overview.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DetailCountOnEmptyDataSource 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_how-to-build-report-pages-progressively-to-be-able-to-access-them-as-soon-as-they-are-e960/CS/XtraReport1.cs#L20

    i = 0;
    ((XtraReport)sender).ReportPrintOptions.DetailCountOnEmptyDataSource = (int)TotalRowCount.Value;
}

Reporting_how-to-print-detailband-multiple-times-regardless-of-the-number-of-records-e3740/CS/WindowsFormsApplication1/XtraReport1.cs#L18

    this.source = source;
    this.ReportPrintOptions.DetailCountOnEmptyDataSource = detailPrintCount;
}

reporting-winforms-repeat-detail-band-multiple-times/CS/dxSample/XtraReport1.cs#L16

    currentDetail = 1;
    DetailReport.ReportPrintOptions.DetailCountOnEmptyDataSource = (int)GetCurrentColumnValue("CategoryID");
}

Reporting_how-to-insert-an-extra-page-between-pages-of-the-second-report-t328469/CS/XtraReportInformation.cs#L15

    InitializeComponent();
    this.ReportPrintOptions.DetailCountOnEmptyDataSource = p;
}

Reporting_aspxdocumentviewer-how-to-implement-a-custom-toolbar-t140471/CS/DocumentViewerWithToolbars/Reports/MyXtraReport.cs#L17

{
    ReportPrintOptions.DetailCountOnEmptyDataSource = Math.Max(Math.Min((int)pageCount.Value, 100), 1);
    PrintingSystem.ProgressReflector.PositionChanged += ProgressReflector_PositionChanged;

VB.NET

Reporting_how-to-build-report-pages-progressively-to-be-able-to-access-them-as-soon-as-they-are-e960/VB/XtraReport1.vb#L22

    i = 0
    CType(sender, XtraReport).ReportPrintOptions.DetailCountOnEmptyDataSource = CInt(Fix(TotalRowCount.Value))
End Sub

Reporting_how-to-print-detailband-multiple-times-regardless-of-the-number-of-records-e3740/VB/WindowsFormsApplication1/XtraReport1.vb#L17

    Me.source = source
    Me.ReportPrintOptions.DetailCountOnEmptyDataSource = detailPrintCount
End Sub

reporting-winforms-repeat-detail-band-multiple-times/VB/dxSample/XtraReport1.vb#L21

    currentDetail = 1
    DetailReport.ReportPrintOptions.DetailCountOnEmptyDataSource = CInt(GetCurrentColumnValue("CategoryID"))
End Sub

Reporting_how-to-insert-an-extra-page-between-pages-of-the-second-report-t328469/VB/XtraReportInformation.vb#L17

    InitializeComponent()
    Me.ReportPrintOptions.DetailCountOnEmptyDataSource = p
End Sub

Reporting_aspxdocumentviewer-how-to-implement-a-custom-toolbar-t140471/VB/DocumentViewerWithToolbars/Reports/MyXtraReport.vb#L15

Private Sub MyXtraReport_BeforePrint(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintEventArgs) Handles MyBase.BeforePrint
    ReportPrintOptions.DetailCountOnEmptyDataSource = Math.Max(Math.Min(CInt((pageCount.Value)), 100), 1)
    AddHandler PrintingSystem.ProgressReflector.PositionChanged, AddressOf ProgressReflector_PositionChanged