This documentation is archived and is not being maintained.

TableCellCollection.Add Method

Appends the specified TableCell to the end of the TableCellCollection.

[Visual Basic]
Public Function Add( _
   ByVal cell As TableCell _
) As Integer
[C#]
public int Add(
 TableCell cell
);
[C++]
public: int Add(
 TableCell* cell
);
[JScript]
public function Add(
   cell : TableCell
) : int;

Parameters

cell
The TableCell to add to the collection.

Return Value

The index number of the TableCell.

Remarks

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

Example

[Visual Basic, C#] 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.

[Visual Basic] 
<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
 <head>
 
    <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 j As Integer
            For j = 0 To numrows - 1
                Dim r As New TableRow()
                Dim i As Integer
                For i = 0 To numcells - 1
                    Dim c As New TableCell()
                    c.Text = counter.ToString()
                    counter += 1
                    r.Cells.Add(c)
                Next i
                Table1.Rows.Add(r)
            Next j
        End Sub
 
    </script>
 
 </head>
 
 <body>
 
    <h3>TableCellCollection Example</h3>
    <form runat=server>
       <asp:Table id="Table1" 
            runat="server"/>
 
    </form>
 
 </body>
 </html>
 

[C#] 
<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
 <head>
 
    <script runat="server">
 
       void Page_Load(Object sender, EventArgs e) 
       {
          
          int numrows = 5;
          int numcells = 6;
          int counter = 1;
          
          // Create a table.
          for (int j=0; j<numrows; j++) 
          {          
             TableRow r = new TableRow();
             for (int i=0; i<numcells; i++) 
             {
                TableCell c = new TableCell();
                c.Text=counter.ToString();
                counter++;
                r.Cells.Add(c);
             }
             Table1.Rows.Add(r);
          }
 
       }
 
    </script>
 
 </head>
 
 <body>
 
    <h3>TableCellCollection Example</h3>
    <form runat=server>
       <asp:Table id="Table1" 
            runat="server"/>
 
    </form>
 
 </body>
 </html>
 

[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family

See Also

TableCellCollection Class | TableCellCollection Members | System.Web.UI.WebControls Namespace | AddAt | AddRange | Cells | TableRow | TableCell

Show: