TableCellCollection Class
Definition
Encapsulates a collection of TableHeaderCell and TableCell objects that make up a row in a Table control. This class cannot be inherited.
public ref class TableCellCollection sealed : System::Collections::IListpublic sealed class TableCellCollection : System.Collections.IListtype TableCellCollection = class
interface IList
interface ICollection
interface IEnumerablePublic NotInheritable Class TableCellCollection
Implements IList- Inheritance
-
TableCellCollection
- Implements
Examples
The following example demonstrates how to programmatically fill a Table control. TableCell objects, which represent individual cells, are added to TableRow objects, which represent the individual rows, through the Cells 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">
private void Page_Load(Object sender, EventArgs e)
{
// Generate rows and cells.
int numrows = 4;
int numcells = 6;
int counter = 1;
for (int rowNum = 0; rowNum < numrows; rowNum++)
{
TableRow rw = new TableRow();
for (int cellNum = 0; cellNum < numcells; cellNum++)
{
TableCell cel = new TableCell();
cel.Text=counter.ToString();
counter++;
rw.Cells.Add(cel);
}
Table1.Rows.Add(rw);
}
}
private void Button_Click_Coord(object sender, EventArgs e)
{
for (int rowNum = 0; rowNum < Table1.Rows.Count; rowNum++)
{
for (int cellNum = 0; cellNum <
Table1.Rows[rowNum].Cells.Count; cellNum++)
{
Table1.Rows[rowNum].Cells[cellNum].Text =
String.Format("(Row{0}, Cell{1})", rowNum, cellNum);
}
}
}
private void Button_Click_Number(object sender, EventArgs e)
{
int counter = 1;
for (int rowNum = 0; rowNum < Table1.Rows.Count; rowNum++)
{
for (int cellNum = 0; cellNum <
Table1.Rows[rowNum].Cells.Count; cellNum++)
{
Table1.Rows[rowNum].Cells[cellNum].Text =
counter.ToString();
counter++;
}
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TableCellCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>TableCellCollection Example</h3>
<asp:Table id="Table1"
runat="server"/>
<br />
<center>
<asp:Button id="Button1"
Text="Display Table Coordinates"
OnClick="Button_Click_Coord"
runat="server"/>
<asp:Button id="Button2"
Text="Display Cell Numbers"
OnClick="Button_Click_Number"
runat="server"/>
</center>
</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">
Private Sub Page_Load(sender As Object, e As EventArgs)
' Generate rows and cells.
Dim numrows As Integer = 4
Dim numcells As Integer = 6
Dim counter As Integer = 1
Dim rowNum As Integer
Dim cellNum As Integer
For rowNum = 0 To numrows - 1
Dim rw As New TableRow()
For cellNum = 0 To numcells - 1
Dim cel As New TableCell()
cel.Text = counter.ToString()
counter += 1
rw.Cells.Add(cel)
Next
Table1.Rows.Add(rw)
Next
End Sub
Private Sub Button_Click_Coord(sender As Object, e As EventArgs)
Dim rowNum As Integer
Dim cellNum As Integer
Dim rowCount As Integer
For rowCount = 0 To Table1.Rows.Count - 1
For cellNum = 0 To (Table1.Rows(rowNum).Cells.Count) - 1
Table1.Rows(rowNum).Cells(cellNum).Text = _
String.Format("(Row{0}, Cell{1})", rowNum, cellNum)
Next
Next
End Sub
Private Sub Button_Click_Number(sender As Object, e As EventArgs)
Dim counter As Integer = 1
Dim rowNum As Integer
Dim cellNum As Integer
For rowNum = 0 To Table1.Rows.Count - 1
For cellNum = 0 To (Table1.Rows(rowNum).Cells.Count) - 1
Table1.Rows(rowNum).Cells(cellNum).Text = _
counter.ToString()
counter += 1
Next
Next
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TableCellCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>TableCellCollection Example</h3>
<asp:Table id="Table1"
runat="server"/>
<br />
<center>
<asp:Button id="Button1"
Text="Display Table Coordinates"
OnClick="Button_Click_Coord"
runat="server"/>
<asp:Button id="Button2"
Text="Display Cell Numbers"
OnClick="Button_Click_Number"
runat="server"/>
</center>
</div>
</form>
</body>
</html>
Remarks
Use this class to programmatically manage a collection of TableCell objects that make up a row in a Table control. This class is commonly used to add or remove cells from a row in 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 TableCell objects in the TableCellCollection. |
| IsReadOnly |
Gets a value indicating whether the TableCellCollection is read-only. |
| IsSynchronized |
Gets a value indicating whether access to the TableCellCollection is synchronized (thread-safe). |
| Item[Int32] |
Gets a TableCell from the TableCellCollection at the specified index. |
| SyncRoot |
Gets the object that can be used to synchronize access to the TableCellCollection. |
Methods
| Add(TableCell) |
Appends the specified TableCell to the end of the TableCellCollection. |
| AddAt(Int32, TableCell) |
Adds the specified TableCell to the TableCellCollection at the specified index location. |
| AddRange(TableCell[]) |
Appends the TableCell objects from the specified array to the end of the collection. |
| Clear() |
Removes all TableCell objects from the TableCellCollection. |
| CopyTo(Array, Int32) |
Copies the items from the TableCellCollection 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) |
| GetCellIndex(TableCell) |
Returns a value that represents the index of the specified TableCell from the TableCellCollection. |
| GetEnumerator() |
Returns a IEnumerator implemented object that contains all TableCell objects in the TableCellCollection. |
| GetHashCode() |
Serves as the default hash function. (Inherited from Object) |
| GetType() |
Gets the Type of the current instance. (Inherited from Object) |
| MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
| Remove(TableCell) |
Removes the specified TableCell from the TableCellCollection. |
| RemoveAt(Int32) |
Removes a TableCell from the TableCellCollection 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. |