This documentation is archived and is not being maintained.

Table.Rows Property

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 */
public TableRowCollection get_Rows ()

public function get Rows () : TableRowCollection

Not applicable.

Property Value

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 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" 


Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0