Export (0) Print
Expand All

Table.Columns Property

Gets a TableColumnCollection object that contains the columns hosted by the table.

Namespace: System.Windows.Documents
Assembly: PresentationFramework (in presentationframework.dll)
XML Namespace:  http://schemas.microsoft.com/winfx/2006/xaml/presentation

public TableColumnCollection Columns { get; }
/** @property */
public TableColumnCollection get_Columns ()

public function get Columns () : TableColumnCollection

You cannot use this property in XAML.

Property Value

A TableColumnCollection object that contains the columns (represented by TableColumn objects) hosted by the table. Note that this number might not be the actual number of columns rendered in the table. It is the TableCell objects in a table that determine how many columns are actually rendered. This property has no default value.

The TableColumn objects returned by this property can, in conjunction with the TableCell objects in the column, be used to define layout of columns but they do not determine the actual number of columns rendered. It is the TableCell objects in a table that determine how many columns are actually rendered. For example, if you define 3 columns but only have table cells for 2 columns, only 2 columns will be rendered.

This example demonstrates some of the more common operations that can be performed on a table's columns through the Columns property.

The following example creates a new table and then uses the Add method to add columns to the table's Columns collection.

Table tbl = new Table();
int columnsToAdd = 4;
for (int x = 0; x < columnsToAdd; x++)
    tbl.Columns.Add(new TableColumn());

The following example inserts a new TableColumn. The new column is inserted at index position 0, making it the new first column in the table.


The TableColumnCollection collection uses standard zero-based indexing.

tbl.Columns.Insert(0, new TableColumn());

The following example accesses some arbitrary properties on columns in the TableColumnCollection collection, referring to particular columns by index.

tbl.Columns[0].Width = new GridLength(20);
tbl.Columns[1].Background = Brushes.AliceBlue;
tbl.Columns[2].Width = new GridLength(20);
tbl.Columns[3].Background = Brushes.AliceBlue;

The following example gets the number of columns currently hosted by the table.

int columns = tbl.Columns.Count;

The following example removes a particular column by reference.


The following example removes a particular column by index.


The following example removes all columns from the table's columns collection.


Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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

Community Additions

© 2014 Microsoft