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)

public TableColumnCollection Columns { get; }

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.


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.

NoteNote

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.


tbl.Columns.Remove(tbl.Columns[3]);


The following example removes a particular column by index.


tbl.Columns.RemoveAt(2);


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


tbl.Columns.Clear();


.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, 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.

Community Additions

ADD
Show:
© 2014 Microsoft