How to: Manipulate a Table's Columns through the Columns Property

Article
2023-02-06

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

Create a new table

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());

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

Insert a 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.

Note

The TableColumnCollection collection uses standard zero-based indexing.

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

tbl.Columns.Insert(0, New TableColumn())

Access properties in the TableColumnCollection

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;

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

Get the number of columns in a table

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

int columns = tbl.Columns.Count;

Dim columns As Integer = tbl.Columns.Count

Remove a column by reference

The following example removes a particular column by reference.

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

tbl.Columns.Remove(tbl.Columns(3))

Remove a column by index

The following example removes a particular column by index.

tbl.Columns.RemoveAt(2);

tbl.Columns.RemoveAt(2)

Remove all the columns

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

tbl.Columns.Clear();

tbl.Columns.Clear()

Share via