XRTableCell Class

A single Cell in an XRTable's Row.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v20.1.dll


public class XRTableCell :
Public Class XRTableCell
    Inherits XRLabel
    Implements IBrickOwner,

Related API Members

The following members accept/return XRTableCell objects:


Use XRTableCell objects to place text or other controls in a table. A table cell behaves like an ordinary label control, and displays text from the XRControl.Text property. If an XRTableCell object contains other controls, it cannot display the text.

You can use the cell's XRControl.Controls property to access the contained controls collection. Use the XRTableCell.Row property to access the cell's row.


When you create large tables in code, set the XRTableCell.Weight property to 1 for all table cells - to improve report generator performance.

See Create a Table Report for more information.

Markup Text

Use markup in table cells to change the text appearance. This behavior is in effect when the AllowMarkupText property is set to true. Refer to AllowMarkupText for more information.


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

using DevExpress.XtraReports.UI;
// ...

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

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

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

// Create a row with the product name and product price cells.
XRTableRow row = new XRTableRow();
XRTableCell productName = new XRTableCell();
XRTableCell productPrice = new XRTableCell();

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