Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Table.Columns Property

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

Namespace:  System.Windows.Documents
Assembly:  PresentationFramework (in PresentationFramework.dll)
Public ReadOnly Property Columns As TableColumnCollection

Property Value

Type: System.Windows.Documents.TableColumnCollection
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.

			Dim tbl As New Table()
			Dim columnsToAdd As Integer = 4
			For x As Integer = 0 To columnsToAdd - 1
				tbl.Columns.Add(New TableColumn())
			Next x

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.

			Dim columns As Integer = 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.


.NET Framework

Supported in: 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
© 2014 Microsoft. All rights reserved.