This documentation is archived and is not being maintained.

TableCellCollection.AddAt Method

Adds the specified TableCell to the TableCellCollection at the specified index location.

[Visual Basic]
Public Sub AddAt( _
   ByVal index As Integer, _
   ByVal cell As TableCell _
)
[C#]
public void AddAt(
 int index,
 TableCell cell
);
[C++]
public: void AddAt(
 int index,
 TableCell* cell
);
[JScript]
public function AddAt(
   index : int,
 cell : TableCell
);

Parameters

index
The location in the TableCellCollection at which to add the TableCell.
cell
The TableCell to add to the TableCellCollection.

Remarks

Use this method to insert the specified TableCell in a TableCellCollection at the specified index.

Example

[Visual Basic, C#] The following example demonstrates how to use the AddAt method to add a TableCell to the middle of 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
            
            ' Generate a basic 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
            
            ' Add cells in the middle of the table. 
            Dim k As Integer
            For k = 0 To numrows - 1
                Dim c As New TableCell()
                c.Text = "Mid"
                Table1.Rows(k).Cells.AddAt(numcells / 2, c)
                counter += 1
            Next k
        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;
          
          // Generate a basic 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);
          }
          
          // Add cells in the middle of the table. 
          for (int k=0; k<numrows; k++) 
          {            
             TableCell c = new TableCell();
             c.Text="Mid";
             Table1.Rows[k].Cells.AddAt(numcells/2, c);
             counter++;
          }
       }
 
    </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 | Add | AddRange | TableCell | TableRow | Cells

Show: