Back to Devexpress

XRTable.EndInit() Method

xtrareports-devexpress-dot-xtrareports-dot-ui-dot-xrtable-a1d6e920.md

latest7.9 KB
Original Source

XRTable.EndInit() Method

Ends the XRTable‘s initialization.

Namespace : DevExpress.XtraReports.UI

Assembly : DevExpress.XtraReports.v25.2.dll

NuGet Package : DevExpress.Reporting.Core

Declaration

csharp
public void EndInit()
vb
Public Sub

Remarks

To create XRTable at runtime and manually add XRTableRow and XRTableCell objects to it, it is always required to enclose this code inside the XRTable.BeginInit and EndInit method calls.

Because the final size of a table does not consider the size of its rows and cells , you need to manually set the table size and width (or, call the XRTable.AdjustSize method) before calling the EndInit method.

Note

The height of a table should be explicitly specified only if the cell content is not expected to stretch the cells (e.g., this may happen when their XRTableCell.CanGrow property is enabled).

Example

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

csharp
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 columns 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
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 columns 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

The following code snippets (auto-collected from DevExpress Examples) contain references to the EndInit() 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.

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

csharp
tableDetail.WidthF = usablePageWidth - remainingSpace;
tableHeader.EndInit();
tableDetail.EndInit();

reporting-winforms-create-table-at-runtime/CS/TableReport.cs#L39

csharp
table.AdjustSize();
table.EndInit();
return table;

reporting-winforms-best-fit-table-column-width/CS/ReportHelper/ReportHelper.cs#L60

csharp
}
table.Key.EndInit();
foreach(var otherTable in table.Value) {

reporting-use-multi-value-parameter-as-table-column-chooser/CS/T333639/SampleReport.cs#L60

csharp
this.tblHeader.EndInit();
this.tblDetail.EndInit();

reporting-mvc-generate-report-dynamically-for-specified-query/CS/ReportForQueryExample/PredefinedReports/TestReport.cs#L71

csharp
dynamicTable.Font = new System.Drawing.Font("Verdana", 8F);
dynamicTable.EndInit();
Detail.Controls.Add(dynamicTable);

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

vb
tableDetail.WidthF = usablePageWidth - remainingSpace
tableHeader.EndInit()
tableDetail.EndInit()

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

vb
table.AdjustSize()
table.EndInit()
Return table

reporting-winforms-best-fit-table-column-width/VB/ReportHelper/ReportHelper.vb#L73

vb
table.Key.EndInit()
For Each otherTable In table.Value

reporting-use-multi-value-parameter-as-table-column-chooser/VB/T333639/SampleReport.vb#L57

vb
Me.tblHeader.EndInit()
Me.tblDetail.EndInit()

reporting-winforms-best-fit-table-row-height/VB/dx_sample/XtraReport1.vb#L21

vb
xrTable2.HeightF = DetailHeight
xrTable2.EndInit()
CreateDocument()

See Also

BeginInit()

XRTable Class

XRTable Members

DevExpress.XtraReports.UI Namespace