TableCellCollection.Add(TableCell) 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.

Appends the specified TableCell to the end of the TableCellCollection.

public:
 int Add(System::Web::UI::WebControls::TableCell ^ cell);

public int Add (System.Web.UI.WebControls.TableCell cell);

member this.Add : System.Web.UI.WebControls.TableCell -> int

Public Function Add (cell As TableCell) As Integer

Parameters

cell: TableCell

The TableCell to add to the collection.

Returns

Int32

The index number of the TableCell.

Examples

The following example demonstrates how to use the Add method to add a TableCell to a TableCellCollection. Note that in the example, the Cells property of the TableRow is an instance of the TableCellCollection class.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    void Page_Load(Object sender, EventArgs e) 
    {
        int numrows = 5;
        int numcells = 6;
        int counter = 1;

        // Create a table.
        for (int rowNum = 0; rowNum < numrows; rowNum++) 
        {          
             TableRow rw = new TableRow();
             for (int cellNum = 0; cellNum < numcells; cellNum++) 
             {
                 TableCell cel = new TableCell();
                 cel.Text=counter.ToString();
                 counter++;
                 rw.Cells.Add(cel);
             }
             Table1.Rows.Add(rw);
        }
    }
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>TableCellCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>TableCellCollection Example</h3>
    <asp:Table id="Table1" runat="server"/>

    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Sub Page_Load(sender As Object, e As EventArgs)
            
        Dim numrows As Integer = 5
        Dim numcells As Integer = 6
        Dim counter As Integer = 1
            
        ' Create a table.
        Dim rowNum As Integer
        For rowNum = 0 To numrows - 1
            Dim rw As New TableRow()
            Dim cellNum As Integer
            For cellNum = 0 To numcells - 1
                Dim cel As New TableCell()
                cel.Text = counter.ToString()
                counter += 1
                rw.Cells.Add(cel)
            Next
            Table1.Rows.Add(rw)
        Next
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>TableCellCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>TableCellCollection Example</h3>
    <asp:Table id="Table1" runat="server"/>

    </div>
    </form>
</body>
</html>

Remarks

Use this method to add the specified TableCell to the end of a TableCellCollection.

Applies to