XRTable.Rows Property

Gets the collection of rows contained in the table.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v20.2.dll

NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Reporting.Core

Declaration

C#

[Browsable(false)]
public XRTableRowCollection Rows { get; }

VB.NET

<Browsable(False)>
Public ReadOnly Property Rows As XRTableRowCollection

Property Value

Type	Description
XRTableRowCollection	An object of the XRTableRowCollection class.

Example

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

Tip

Online Example: Runtime table creation best practices (iterative approach)

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 and add it to the detail band.
XRTable table = new XRTable();
detailBand.Controls.Add(table);

// 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();

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 and add it to the detail band.
Dim table As New XRTable()
detailBand.Controls.Add(table)

' 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()

The following code sample creates an XRTable at runtime and binds the table to data:

C#

using DevExpress.XtraReports.UI;
using DevExpress.DataAccess.Sql;
using DevExpress.DataAccess.ConnectionParameters;
// ...
private static SqlDataSource CreateSQLDataSource() {
    // Create a data source with the required connection parameters.  
    Access97ConnectionParameters connectionParameters = new Access97ConnectionParameters("Data/nwind.mdb", "", "");
    SqlDataSource dataSource = new SqlDataSource(connectionParameters);

    // Create a SELECT query.
    SelectQuery query = SelectQueryFluentBuilder
        .AddTable("Products")
        .SelectColumn("ProductName")
        .SelectColumn("UnitPrice")
        .Build("selectQuery");

    // Add the query to the collection and return the data source. 
    dataSource.Queries.Add(query);
    dataSource.Fill();
    return dataSource;
}
// ...
// Create a new data source.
SqlDataSource sqlDataSource = CreateSQLDataSource();

// Create a new report and assign the data source to it.
XtraReport report = new XtraReport();
report.DataSource = sqlDataSource;
report.DataMember = "Products";

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

// Create a table and add it to the detail band.
XRTable table = new XRTable();
detailBand.Controls.Add(table);

// Create a row and add the product name and product price cells to the row.
table.BeginInit();

XRTableRow row = new XRTableRow();
table.Rows.Add(row);

XRTableCell productName = new XRTableCell();
XRTableCell productPrice = new XRTableCell();

row.Cells.Add(productName);
row.Cells.Add(productPrice);

// Bind the table cells to the data fields.
productName.ExpressionBindings.Add(new ExpressionBinding("BeforePrint", "Text", "[ProductName]"));
productPrice.ExpressionBindings.Add(new ExpressionBinding("BeforePrint", "Text", "[UnitPrice]"));

table.EndInit();

VB.NET

Imports DevExpress.XtraReports.UI
Imports DevExpress.DataAccess.Sql
Imports DevExpress.DataAccess.ConnectionParameters
' ...
Private Shared Function CreateSQLDataSource() As SqlDataSource
    ' Create a data source with the required connection parameters.  
    Dim connectionParameters As New Access97ConnectionParameters("Data/nwind.mdb", "", "")
    Dim dataSource As New SqlDataSource(connectionParameters)

    ' Create a SELECT query.
    Dim query As SelectQuery = SelectQueryFluentBuilder.AddTable("Products").SelectColumn("ProductName").SelectColumn("UnitPrice").Build("selectQuery")

    ' Add the query to the collection and return the data source. 
    dataSource.Queries.Add(query)
    dataSource.Fill()
    Return dataSource
End Function
' ...
' Create a new data source.
Dim sqlDataSource As SqlDataSource = CreateSQLDataSource()

' Create a new report and assign the data source to it.
Dim report As New XtraReport()
report.DataSource = sqlDataSource
report.DataMember = "Products"

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

' Create a table and add it to the detail band.
Dim table As New XRTable()
detailBand.Controls.Add(table)

' Create a row and add the product name and product price cells to the row.
table.BeginInit()

Dim row As New XRTableRow()
table.Rows.Add(row)

Dim productName As New XRTableCell()
Dim productPrice As New XRTableCell()

row.Cells.Add(productName)
row.Cells.Add(productPrice)

' Bind the table cells to the data fields.
productName.ExpressionBindings.Add(New ExpressionBinding("BeforePrint", "Text", "[ProductName]"))
productPrice.ExpressionBindings.Add(New ExpressionBinding("BeforePrint", "Text", "[UnitPrice]"))

table.EndInit()

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Rows 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-use-the-web-document-viewer-in-javascript-with-reactjs-t561300/CS/ServerSide/XtraReport2.cs#L190

this.xrTable1.Name = "xrTable1";
this.xrTable1.Rows.AddRange(new DevExpress.XtraReports.UI.XRTableRow[] {
this.xrTableRow1});

Reporting_how-to-use-the-web-report-designer-in-javascript-with-reactjs-t561295/CS/ServerSide/XtraReport1.cs#L196

this.xrTable1.Name = "xrTable1";
this.xrTable1.Rows.AddRange(new DevExpress.XtraReports.UI.XRTableRow[] {
this.xrTableRow1});

Reporting_how-to-create-a-label-in-the-pageheader-band-when-a-field-is-dragged-from-the-t457241/CS/T457241/Form1.cs#L54

headerBand = CreatePageHeaderBand(designer.Report);
XRTableRow sourceRow = (e.Component as XRTable).Rows[0];
XRTable headerTable = CreateTable(sourceRow, headerBand.HeightF);

VB.NET

Reporting_how-to-use-the-web-document-viewer-in-javascript-with-reactjs-t561300/VB/ServerSide/XtraReport2.vb#L186

Me.xrTable1.Name = "xrTable1"
Me.xrTable1.Rows.AddRange(New DevExpress.XtraReports.UI.XRTableRow() { Me.xrTableRow1})
Me.xrTable1.SizeF = New System.Drawing.SizeF(650F, 28F)

Reporting_how-to-use-the-web-report-designer-in-javascript-with-reactjs-t561295/VB/ServerSide/XtraReport1.vb#L192

Me.xrTable1.Name = "xrTable1"
Me.xrTable1.Rows.AddRange(New DevExpress.XtraReports.UI.XRTableRow() { Me.xrTableRow1})
Me.xrTable1.SizeF = New System.Drawing.SizeF(650F, 28F)