Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated - Rate this topic

TableRowCollection Class

.NET Framework 4

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

System.Object
  System.Web.UI.WebControls.TableRowCollection

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)
C#
C++
F#
VB
Copy 
public sealed class TableRowCollection : IList, 
	ICollection, IEnumerable

The TableRowCollection type exposes the following members.

  Name Description
Public property Count Gets the number of TableRow objects in the TableRowCollection.
Public property IsReadOnly Gets a value indicating whether the TableRowCollection is read-only.
Public property IsSynchronized Gets a value indicating whether access to the TableRowCollection is synchronized (thread-safe).
Public property Item Gets a TableRow from the TableRowCollection at the specified index.
Public property SyncRoot Gets the object that can be used to synchronize access to the TableRowCollection.
Top
  Name Description
Public method Add Appends the specified TableRow object to the end of the TableRowCollection.
Public method AddAt Adds the specified TableRow object to the TableRowCollection at the specified index location.
Public method AddRange Appends the TableRow objects from the specified array to the end of the collection.
Public method Clear Removes all TableRow controls from the TableRowCollection.
Public method CopyTo Copies the items from the TableRowCollection to the specified System.Array, starting with the specified index in the System.Array.
Public method Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetEnumerator Returns a System.Collections.IEnumerator implemented object that contains all TableRow objects within the TableRowCollection.
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetRowIndex Returns a value that represents the index of the specified TableRow from the TableRowCollection.
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method Remove Removes the specified TableRow from the TableRowCollection.
Public method RemoveAt Removes a TableRow from the TableRowCollection at the specified index.
Public method ToString Returns a string that represents the current object. (Inherited from Object.)
Top
  Name Description
Public Extension Method AsParallel Enables parallelization of a query. (Defined by ParallelEnumerable.)
Public Extension Method AsQueryable Converts an IEnumerable to an IQueryable. (Defined by Queryable.)
Public Extension Method Cast<TResult> Casts the elements of an IEnumerable to the specified type. (Defined by Enumerable.)
Public Extension Method OfType<TResult> Filters the elements of an IEnumerable based on a specified type. (Defined by Enumerable.)
Top
  Name Description
Explicit interface implemetation Private method IList.Add Infrastructure. Adds an object to the collection.
Explicit interface implemetation Private method IList.Contains Infrastructure. Determines whether the specified object is contained within the collection.
Explicit interface implemetation Private method IList.IndexOf Infrastructure. Searches for the specified object and returns the zero-based index of the first occurrence within the collection.
Explicit interface implemetation Private method IList.Insert Infrastructure. Inserts an object into the collection at the specified index.
Explicit interface implemetation Private property IList.IsFixedSize Infrastructure. For a description of this member, see IsFixedSize.
Explicit interface implemetation Private property IList.Item Infrastructure. For a description of this member, see Item.
Explicit interface implemetation Private method IList.Remove Infrastructure. Removes an object from the collection.
Top

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

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.

C#
VB
Copy 

<%@ 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>
None
Copy 


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

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ