Skip to main content
Tab

GridViewDataColumn.CellRowSpan Property

Specifies the number of rows that a column (i.e., column header and data cells containing the column data) spans.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.2.dll

Declaration

[DefaultValue(1)]
public int CellRowSpan { get; set; }

Property Value

Type Default Description
Int32 1

An integer value that specifies the number of rows that the column spans.

Remarks

When the grid uses data cell bands, the grid header’s height is equal to the maximum depth of the column hierarchy. By default, a column occupies one row; the deepest column (without child columns) occupies the remaining free space.

Use the CellRowSpan property to specify the number of rows that a column (i.e., column header and data cells) spans.

Example 1

The maximum depth of a columns hierarchy is equal to three (for the Address column). By default, the Photo column occupies one row, and the deepest child column (Price) occupies remaining free space, i.e., two rows.

<dx:ASPxGridView ID="Grid" >
    <Columns>
        <dx:GridViewDataImageColumn FieldName="PhotoUrl" Caption="Photo" />
        <dx:GridViewDataColumn FieldName="Address" CellRowSpan="3">
            <Columns>
                <dx:GridViewDataColumn FieldName="Features">
                    <Columns>
                        <dx:GridViewDataColumn FieldName="Beds" />
                        <dx:GridViewDataColumn FieldName="Baths" />
                        <dx:GridViewDataColumn FieldName="HouseSize" />
                        <dx:GridViewDataColumn FieldName="YearBuilt" />
                    </Columns>
                </dx:GridViewDataColumn>
                <dx:GridViewDataSpinEditColumn FieldName="Price" />
            </Columns>
        </dx:GridViewDataColumn>
    </Columns>
</dx:ASPxGridView>

CellRowSpan1

Example 2

In this example, the CellRowSpan property is set to 2 for Photo column, therefore it occupies two rows.

<dx:ASPxGridView ID="Grid" >
    <Columns>
        <dx:GridViewDataImageColumn FieldName="PhotoUrl" Caption="Photo" CellRowSpan="2" />
        <dx:GridViewDataColumn FieldName="Address" >
            <Columns>
                <dx:GridViewDataColumn FieldName="Features">
                    <Columns>
                        <dx:GridViewDataColumn FieldName="Beds" />
                        <dx:GridViewDataColumn FieldName="Baths" />
                        <dx:GridViewDataColumn FieldName="HouseSize" />
                        <dx:GridViewDataColumn FieldName="YearBuilt" />
                    </Columns>
                </dx:GridViewDataColumn>
                <dx:GridViewDataSpinEditColumn FieldName="Price" />
            </Columns>
        </dx:GridViewDataColumn>
    </Columns>
</dx:ASPxGridView>

CellRowSpan2

Concept

Data Cell Bands

Online Example

ASPxGridView - How to create header and data cell bands

Online Demo

ASPxGridView - Data Cell Bands

Online Video

ASPxGridView - Data Cell Bands

See Also