TableRowCollection Class
Definition
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
-
TableRowCollection
- Implements
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. |