TableRow.CellControlCollection.Add(Control) Method

  • Reference

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Adds the specified Control object to the TableRow.CellControlCollection collection.

public:
 override void Add(System::Web::UI::Control ^ child);
public override void Add (System.Web.UI.Control child);
override this.Add : System.Web.UI.Control -> unit
Public Overrides Sub Add (child As Control)

Parameters

child
Control

The Control to add to the TableRow.CellControlCollection.

Exceptions

ArgumentException

The added Control must be of the type TableCell.

Examples

The following code example demonstrates how to create a table, add elements to the table programmatically, and then display the table on the Web page. Note how the Cells property of the TableRow control represents a TableRow.CellControlCollection collection and how the Add method is used to add cells to the row.

This code example is part of a larger example provided for the TableRow class.

// Create more rows for the table.
for (int rowNum = 2; rowNum < 10; rowNum++)
{
    TableRow tempRow = new TableRow();
    for (int cellNum = 0; cellNum < 3; cellNum++)
    {
        TableCell tempCell = new TableCell();
        tempCell.Text = 
            String.Format("({0},{1})", rowNum, cellNum);
        tempRow.Cells.Add(tempCell);
    }
    Table1.Rows.Add(tempRow);
}

' Create more rows for the table.
Dim rowNum As Integer
For rowNum = 2 To 9
    Dim tempRow As New TableRow()
    Dim cellNum As Integer
    For cellNum = 0 To 2
        Dim tempCell As New TableCell()
        tempCell.Text = _
            String.Format("({0},{1})", rowNum, cellNum)
        tempRow.Cells.Add(tempCell)
    Next
    Table1.Rows.Add(tempRow)
Next

Remarks

The added control can be only a TableCell object; otherwise, an ArgumentException is thrown.

Applies to

See also