This documentation is archived and is not being maintained.

TableRowCollection.AddAt Method

Adds the specified TableRow to the TableRowCollection at the specified index location.

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

Parameters

index
The location in the TableRowCollection at which to add the TableRow.
row
The TableRow to add to the TableRowCollection.

Remarks

Use this method to insert the specified TableRow in a TableRowCollection at the specified index.

Example

[Visual Basic, C#] The following example demonstrates how to add a TableRow to the middle of a TableRowCollection. Note that in the example, the Rows property of the Table is an instance of the TableRowCollection 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 = 4
            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 a row in the middle of the table.
            Dim new_r As New TableRow()
            Table1.Rows.AddAt(numrows / 2, new_r)
            
            Dim k As Integer
            For k = 0 To numcells - 1
                Dim c As New TableCell()
                c.Text = "Mid"
                Table1.Rows((numrows / 2)).Cells.AddAt(k, 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 = 4;
          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 a row in the middle of the table.
          TableRow new_r = new TableRow();
          Table1.Rows.AddAt(numrows/2, new_r);
  
          for (int k=0; k<numcells; k++) {            
             TableCell c = new TableCell();
             c.Text="Mid";
             Table1.Rows[numrows/2].Cells.AddAt(k, 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

TableRowCollection Class | TableRowCollection Members | System.Web.UI.WebControls Namespace | TableRow | Table | Rows

Show: