TableRowCollection Class

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.

Encapsulates a collection of TableRow objects that represent a single row in a Table control. This class cannot be inherited.

public ref class TableRowCollection sealed : System::Collections::IList

public sealed class TableRowCollection : System.Collections.IList

type TableRowCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public NotInheritable Class TableRowCollection
Implements IList

Inheritance: Object
TableRowCollection

Implements: ICollection IEnumerable IList

Examples

The following example demonstrates how to programmatically add rows to a table by adding TableRow objects, which represent the rows of the table, to the Table control through the Rows property.

<%@ 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)
    {
        // Generate rows and cells.           
        int numRows = 3;
        int numCells = 2;
        for (int rowNum = 0; rowNum < numRows; rowNum++)
        {
            TableRow rw = new TableRow();
            for (int cellNum = 0; cellNum < numCells; cellNum++)
            {
                TableCell cel = new TableCell();
                cel.Text = String.Format(
                    "row {0}, cell {1}", rowNum, cellNum);
                rw.Cells.Add(cel);
            }
            Table1.Rows.Add(rw);
            Table1.GridLines = GridLines.Both;
            Table1.CellPadding = 4;
            Table1.CellSpacing = 0;
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Programmatic Table</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <h3>Table Example, constructed programmatically</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)
        ' Generate rows and cells.           
        Dim numRows As Integer = 3
        Dim numcells As Integer = 2
        Dim rowNum As Integer
        For rowNum = 0 To numRows - 1
            Dim rw As New TableRow()
            Dim cellNum As Integer
            For cellNum = 0 To numcells - 1
                Dim cel As New TableCell()
                cel.Text = String.Format( _
                    "row {0}, cell {1}", rowNum, cellNum)
                rw.Cells.Add(cel)
            Next cellNum
            Table1.Rows.Add(rw)
        Next rowNum
        Table1.GridLines = GridLines.Both
        Table1.CellPadding = 4
        Table1.CellSpacing = 0
    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>Table Example, constructed programmatically</h3>
        <asp:Table id="Table1" runat="server"/>
    </div>
    </form>
</body>
</html>


<html>
<head>
    <script language="C#" runat="server">
        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.Text="row " + j.ToString() + ", cell " + i.ToString();
                    r.Cells.Add(c);
                }
                Table1.Rows.Add(r);
            }
        }
    </script>
</head>
<body>
    <h3><font face="Verdana">Table Example, constructed programmatically</font></h3>
    <form runat=server>
        <asp:Table id="Table1"
             runat="server"/>
    </form>
</body>
</html>

Remarks

Use this class to programmatically manage a collection of TableRow objects. This class is commonly used to add or remove rows from a Table control.

Note

A Table control contains a Rows collection that represents a collection of TableRow objects. Each TableRow represents an individual row in the table and contains a Cells collection that represents a collection of TableCell objects. These TableCell objects represent the individual cells in the table. To get an individual cell, you must first get a TableRow from the Rows collection of a Table control. You can then get a TableCell from the Cells collection of the TableRow.

Properties

Count	Gets the number of TableRow objects in the TableRowCollection.
IsReadOnly	Gets a value indicating whether the TableRowCollection is read-only.
IsSynchronized	Gets a value indicating whether access to the TableRowCollection is synchronized (thread-safe).
Item[Int32]	Gets a TableRow from the TableRowCollection at the specified index.
SyncRoot	Gets the object that can be used to synchronize access to the TableRowCollection.

Methods

Add(TableRow)	Appends the specified TableRow object to the end of the TableRowCollection.
AddAt(Int32, TableRow)	Adds the specified TableRow object to the TableRowCollection at the specified index location.
AddRange(TableRow[])	Appends the TableRow objects from the specified array to the end of the collection.
Clear()	Removes all TableRow controls from the TableRowCollection.
CopyTo(Array, Int32)	Copies the items from the TableRowCollection to the specified Array, starting with the specified index in the Array.
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetEnumerator()	Returns a IEnumerator implemented object that contains all TableRow objects within the TableRowCollection.
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetRowIndex(TableRow)	Returns a value that represents the index of the specified TableRow from the TableRowCollection.
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
Remove(TableRow)	Removes the specified TableRow from the TableRowCollection.
RemoveAt(Int32)	Removes a TableRow from the TableRowCollection at the specified index.
ToString()	Returns a string that represents the current object. (Inherited from Object)

Explicit Interface Implementations

IList.Add(Object)	Adds an object to the collection.
IList.Contains(Object)	Determines whether the specified object is contained within the collection.
IList.IndexOf(Object)	Searches for the specified object and returns the zero-based index of the first occurrence within the collection.
IList.Insert(Int32, Object)	Inserts an object into the collection at the specified index.
IList.IsFixedSize	For a description of this member, see IsFixedSize.
IList.Item[Int32]	For a description of this member, see Item[Int32].
IList.Remove(Object)	Removes an object from the collection.

Extension Methods

Cast<TResult>(IEnumerable)	Casts the elements of an IEnumerable to the specified type.
OfType<TResult>(IEnumerable)	Filters the elements of an IEnumerable based on a specified type.
AsParallel(IEnumerable)	Enables parallelization of a query.
AsQueryable(IEnumerable)	Converts an IEnumerable to an IQueryable.

Applies to

Jaa