This documentation is archived and is not being maintained.

TableCell.ColumnSpan Property

Gets or sets the number of columns in the Table control that the cell spans.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public virtual int ColumnSpan { get; set; }
<asp:TableCell ColumnSpan="Int32" />

Property Value

Type: System.Int32
The number of columns in the rendered table that the cell spans. The default value is 0, which indicates that this property is not set.

ExceptionCondition
ArgumentOutOfRangeException

The selected value is less than 0.

Use the ColumnSpan property to specify or determine the number of columns in the rendered table that the cell spans. For example, if you set this property to 2, the cell takes up two columns in the Table control.

The following code example demonstrates how to declaratively specify the ColumnSpan of a TableCell control. In particular, note how the last row's single cell spans three columns. For a complete, working code example, see the TableHeaderCell class overview topic.

<asp:TableCell AssociatedHeaderCellID="Column1Header Column2Header Column3Header"
ColumnSpan="3"
HorizontalAlign="Left">(2,0)
</asp:TableCell>

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: