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.v19.1.dll

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

Declaration

C#

[Browsable(false)]
[DefaultValue(0)]
public double Weight { get; set; }

VB.NET

<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.

Example

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.

C#

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;
}

VB.NET

Imports DevExpress.XtraReports.UI
' ...

Private Function CreateLargeTable(rowCount As Integer, cellCount As Integer) As XRTable
    Dim table As New XRTable()
    table.BeginInit()
    For i As Integer = 0 To rowCount - 1
        Dim row As New XRTableRow() With {.Weight = 1}
        For j As Integer = 0 To cellCount - 1
            Dim cell As New XRTableCell() With {.Weight = 1}
            row.Cells.Add(cell)
        Next
        table.Rows.Add(row)
    Next
    table.EndInit()

    Return table
End Function

Related GitHub Examples

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

this.xrTableCell1.Text = "Category Name";
this.xrTableCell1.Weight = 0.56571425217848559D;
//

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

this.xrTableCell1.Text = "Product Name";
this.xrTableCell1.Weight = 0.36220473069411058D;
//

VB.NET

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

Me.xrTableCell1.Text = "Category Name"
Me.xrTableCell1.Weight = 0.56571425217848559R
'

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

Me.xrTableCell1.Text = "Product Name"
Me.xrTableCell1.Weight = 0.36220473069411058R
'