TableRowCollection.AddAt(Int32, TableRow) 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 TableRow object to the TableRowCollection at the specified index location.

public:
 void AddAt(int index, System::Web::UI::WebControls::TableRow ^ row);

public void AddAt(int index, System.Web.UI.WebControls.TableRow row);

member this.AddAt : int * System.Web.UI.WebControls.TableRow -> unit

Public Sub AddAt (index As Integer, row As TableRow)

Parameters

index: Int32

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

row: TableRow

The TableRow object to add to the TableRowCollection.

Examples

The following example demonstrates how to add a TableRow object to the middle of a TableRowCollection. Note that in the example, the Rows property of the Table is an instance of the TableRowCollection class.

ASP.NET (C#)

<%@ 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 = 4;
        int numCells = 6;
        int counter = 1;

        // Generate a basic 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);
        }

        // Add a row in the middle of the table.
        TableRow new_rw = new TableRow();
        Table1.Rows.AddAt(numRows / 2, new_rw);

        for (int cellNum = 0; cellNum < numCells; cellNum++)
        {
            TableCell cel = new TableCell();
            cel.Text = "Mid";
            Table1.Rows[numRows / 2].Cells.AddAt(cellNum, cel);
            counter++;
        }
    }
</script>
 
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Programmatic Table</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <h3>Programmatic Table 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(ByVal sender As Object, ByVal e As EventArgs)
            
        Dim numRows As Integer = 4
        Dim numCells As Integer = 6
        Dim counter As Integer = 1
        Dim cellNum As Integer

        ' Generate a basic table.         
        Dim rowNum As Integer
        For rowNum = 0 To numRows - 1
            Dim rw As New TableRow()
            For cellNum = 0 To numCells - 1
                Dim cel As New TableCell()
                cel.Text = counter.ToString()
                counter += 1
                rw.Cells.Add(cel)
            Next cellNum
            Table1.Rows.Add(rw)
        Next rowNum
            
        ' Add a row in the middle of the table.
        Dim new_rw As New TableRow()
        Table1.Rows.AddAt(numRows / 2, new_rw)
            
        For cellNum = 0 To numCells - 1
            Dim cel As New TableCell()
            cel.Text = "Mid"
            Table1.Rows((numRows / 2)).Cells.AddAt(cellNum, cel)
            counter += 1
        Next cellNum
    End Sub
</script>

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

Remarks

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

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