TableRow.CellControlCollection.Add(Control) Method

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

Product	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Share via