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; }
/** @property */
public int get_ColumnSpan ()

/** @property */
public void set_ColumnSpan (int value)

public function get ColumnSpan () : int

public function set ColumnSpan (value : int)

Not applicable.

Property Value

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.

Exception typeCondition


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"

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0