Table.Rows Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets the collection of rows in the Table control.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public virtual TableRowCollection Rows { get; }

Property Value

Type: System.Web.UI.WebControls.TableRowCollection

A TableRowCollection that contains the TableRow objects in the Table control.

Use the Rows collection to programmatically manage the TableRow objects in the Table control. A TableRow represents a row in the table.


This property is normally used only when building tables programmatically. At design time, it is set by declaring TableRow objects between the opening and closing tags of the Table control.

The following example demonstrates how use the Rows collection to construct a table programmatically. Creating a table dynamically consists of three steps. First, create TableCell objects to represent the cells in a row. Content for the cells is added by either setting the Text property or by adding controls to the Control.Controls collection of the TableCell. Next, create a TableRow to represent a row in the table. Add the TableCell objects created earlier to the Cells collection of the TableRow. Finally, add the TableRow to the Rows collection of the Table control. Repeat this process for each row in the table.


The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code sample must be copied into an empty text file that has an. aspx extension. For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 

<script runat="server">

    private void Page_Load(Object sender, EventArgs e)
        // Generate rows and cells.           
        int numrows = 3;
        int numcells = 2;
        for (int j = 0; j < numrows; j++)
            TableRow r = new TableRow();
            for (int i = 0; i < numcells; i++) {
                TableCell c = new TableCell();
                c.Controls.Add(new LiteralControl("row " 
                    + j.ToString() + ", cell " + i.ToString()));


<html xmlns="" >
<head runat="server">
    <title>Untitled Page</title>
    <form id="form1" runat="server">

    <h3>Table Example, constructed programmatically</h3>
    <asp:Table id="Table1" 


.NET Framework
Available since 1.1
Return to top