XRTableRowCollection.Add(XRTableRow) Method

Appends the specified table row to the current collection.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v24.2.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

C#

public int Add(
    XRTableRow row
)

VB.NET

Public Function Add(
    row As XRTableRow
) As Integer

Parameters

Name	Type	Description
row	XRTableRow	An XRTableRow object to append to the collection.

Returns

Type	Description
Int32	An integer value indicating the position into which a new element was inserted.

Remarks

This method adds the object to the end of the collection.

Note

If you’re creating an XRTable object at runtime and manually add XRTableRow and XRTableCell objects to it, it is always required to enclose this code inside the XRTable.BeginInit and XRTable.EndInit method calls. Also, the final size of the table doesn’t consider the size of table rows and table cells being added to it. So, you need to manually set the table size and width before calling the XRTable.EndInit method.

Example

The code sample below illustrates how to create an XRTable at runtime.

C#

using DevExpress.XtraReports.UI;
// ...
// Create a report.
XtraReport report = new XtraReport();

// Create a detail band and add it to the report.
DetailBand detailBand = new DetailBand();
report.Bands.Add(detailBand);

// Create a table.
XRTable table = new XRTable();

// Add rows and colums to the table.
int numRows = 10;
int numCols = 20;

table.BeginInit();

for (int i = 0; i < numRows; i++) {
    XRTableRow row = new XRTableRow();
    table.Rows.Add(row);

    for (int j = 0; j < numCols; j++) {
        XRTableCell cell = new XRTableCell();
        table.Rows[i].Cells.Add(cell);
    }
}

// Set table size.
table.HeightF = 50;
table.WidthF = 500;

table.EndInit();

// Add the table to the detail band and adjust the band height.
detailBand.Controls.Add(table);
detailBand.HeightF = table.HeightF;

VB.NET

Imports DevExpress.XtraReports.UI
' ...
            ' Create a report.
            Dim report As New XtraReport()

            ' Create a detail band and add it to the report.
            Dim detailBand As New DetailBand()
            report.Bands.Add(detailBand)

            ' Create a table.
            Dim table As New XRTable()

            ' Add rows and colums to the table.
            Dim numRows As Integer = 10
            Dim numCols As Integer = 20

            table.BeginInit()

            For i As Integer = 0 To numRows - 1
                Dim row As New XRTableRow()
                table.Rows.Add(row)

                For j As Integer = 0 To numCols - 1
                    Dim cell As New XRTableCell()
                    table.Rows(i).Cells.Add(cell)
                Next j
            Next i

            ' Set table size.
            table.HeightF = 50
            table.WidthF = 500

            table.EndInit()

            ' Add the table to the detail band and adjust the band height.
            detailBand.Controls.Add(table)
            detailBand.HeightF = table.HeightF

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Add(XRTableRow) method.

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-winforms-create-table-at-runtime/CS/TableReport.cs#L34

    }
    table.Rows.Add(row);
}

winforms-create-a-custom-exporter-for-pivotgridcontrol-with-xtrareport/CS/Report_at_Runtime/PivotReportGenerator.cs#L208

XRTableRow headerRow = new XRTableRow();
header.Rows.Add(headerRow);
XRTableRow detailRow = new XRTableRow();

winforms-reporting-create-grid-based-report/CS/ConvertGridToReportExample/XtraReport1.cs#L74

}
table.Rows.Add(row);
table.WidthF = usefulPageWidth;

reporting-winforms-create-simple-table/CS/XRTableTest/XtraReport1.cs#L38

row.Cells.Add(cell1);
table.Rows.Add(row);

reporting-wpf-create-drill-down-report-document-preview-control/CS/dxWPFApp/MainWindow.xaml.cs#L108

}
tbl.Rows.Add(row);
tbl.BeforePrint += tbl_BeforePrint;

VB.NET

reporting-winforms-create-table-at-runtime/VB/TableReport.vb#L35

    Next j
    table.Rows.Add(row)
Next i

winforms-create-a-custom-exporter-for-pivotgridcontrol-with-xtrareport/VB/Report_at_Runtime/PivotReportGenerator.vb#L212

Dim headerRow As DevExpress.XtraReports.UI.XRTableRow = New DevExpress.XtraReports.UI.XRTableRow()
header.Rows.Add(headerRow)
Dim detailRow As DevExpress.XtraReports.UI.XRTableRow = New DevExpress.XtraReports.UI.XRTableRow()

asp-net-mvc-grid-create-report-based-on-grid-layout/VB/E4755/Models/ReportHelperMVC.vb#L134

Next i
headerTable.Rows.Add(row)
headerTable.Width = pagewidth

winforms-reporting-create-grid-based-report/VB/ConvertGridToReportExample/XtraReport1.vb#L71

Next i
table.Rows.Add(row)
table.WidthF = usefulPageWidth

reporting-winforms-create-simple-table/VB/XRTableTest/XtraReport1.vb#L40

row.Cells.Add(cell1)
table.Rows.Add(row)