Export (0) Print
Expand All

TableColumnCollection.Add Method

Appends a specified item to the collection.

Namespace:  System.Windows.Documents
Assembly:  PresentationFramework (in PresentationFramework.dll)

public void Add(
	TableColumn item
)

Parameters

item
Type: System.Windows.Documents.TableColumn

A table column to append to the collection of columns.

Implements

ICollection<T>.Add(T)

ExceptionCondition
ArgumentException

Raised when item already belongs to a collection.

ArgumentNullException

Raised when item is null.

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.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

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.

Show:
© 2014 Microsoft