A newer version of this page is available. Switch to the current version.

XRTableCell.Weight Property

Specifies the relative size of the XRTableCell in respect to the sizes of other cells in a row.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v18.2.dll

Declaration

[Browsable(false)]
[DefaultValue(0)]
public double Weight { get; set; }
<Browsable(False)>
<DefaultValue(0)>
Public Property Weight As Double

Property Value

Type Default Description
Double

0

Specifies the cell's size in relation to other cells.

Remarks

When creating large tables in code, you can increase the report generator performance by setting the Weight property to 1 for all table cells.

Examples

If you create all table rows and cells manually, like in the code sample below, you may run into report performance issues. Set the XRTableRow.Weight and XRTableCell.Weight properties to 1 for all table rows and cells, respectively, to improve the performance.

NOTE

We do not recommend this approach. Use the approach described in the Create a Table at Runtime section.

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

private XRTable CreateLargeTable(int rowCount, int cellCount) {
    XRTable table = new XRTable();
    table.BeginInit();
    for (int i = 0; i < rowCount; i++) {
        XRTableRow row = new XRTableRow() {
            // Set the row's Weight property to improve the performance.
            Weight = 1 
        };
        for (int j = 0; j < cellCount; j++) {
            XRTableCell cell = new XRTableCell() {
            // Set the cell's Weight property to improve the performance.
                Weight = 1
            };
            row.Cells.Add(cell);
        }
        table.Rows.Add(row);
    }
    table.EndInit();

    return table;
}
See Also