HtmlTableCellCollection Class

HtmlTableCellCollection Class

 

A collection of HtmlTableCell objects that represent the cells in a single row of an HtmlTable control. This class cannot be inherited.

Namespace:   System.Web.UI.HtmlControls
Assembly:  System.Web (in System.Web.dll)

System.Object
  System.Web.UI.HtmlControls.HtmlTableCellCollection

public sealed class HtmlTableCellCollection : ICollection, IEnumerable

NameDescription
System_CAPS_pubpropertyCount

Gets the number of HtmlTableCell objects in the HtmlTableCellCollection collection.

System_CAPS_pubpropertyIsReadOnly

Gets a value indicating whether the HtmlTableCellCollection collection is read-only.

System_CAPS_pubpropertyIsSynchronized

Gets a value indicating whether access to the HtmlTableCellCollection collection is synchronized (thread safe).

System_CAPS_pubpropertyItem[Int32]

Gets the HtmlTableCell object at the specified index from the HtmlTableCellCollection collection.

System_CAPS_pubpropertySyncRoot

Gets the object that can be used to synchronize access to the HtmlTableCellCollection collection.

NameDescription
System_CAPS_pubmethodAdd(HtmlTableCell)

Appends the specified HtmlTableCell object to the end of the HtmlTableCellCollection collection.

System_CAPS_pubmethodClear()

Removes all HtmlTableCell objects from the HtmlTableCellCollection collection.

System_CAPS_pubmethodCopyTo(Array, Int32)

Copies the items from the HtmlTableCellCollection collection to the specified System.Array, beginning with the specified index in the System.Array.

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_pubmethodGetEnumerator()

Returns a System.Collections.IEnumerator-implemented object that contains all HtmlTableCell objects in the HtmlTableCellCollection collection.

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodInsert(Int32, HtmlTableCell)

Adds the specified HtmlTableCell object at the specified index location of the HtmlTableCellCollection collection.

System_CAPS_pubmethodRemove(HtmlTableCell)

Removes the specified HtmlTableCell object from the HtmlTableCellCollection collection.

System_CAPS_pubmethodRemoveAt(Int32)

Removes the HtmlTableCell object at the specified index from the HtmlTableCellCollection collection.

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

NameDescription
System_CAPS_pubmethodAsParallel()

Overloaded. Enables parallelization of a query.(Defined by ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Overloaded. Converts an IEnumerable to an IQueryable.(Defined by Queryable.)

System_CAPS_pubmethodCast<TResult>()

Casts the elements of an IEnumerable to the specified type.(Defined by Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filters the elements of an IEnumerable based on a specified type.(Defined by Enumerable.)

Use the HtmlTableCellCollection class to programmatically manage a collection of HtmlTableCell objects that represent the cells of a single row in an HtmlTable control. This class is commonly used to add, remove, or modify the contents of a cell in a row of an HtmlTable control.

System_CAPS_noteNote

An HtmlTable control contains a Rows property that contains a collection of HtmlTableRow objects. Each HtmlTableRow object represents an individual row in the table. An HtmlTableRow object contains a Cells property that represents a collection of HtmlTableCell objects. These objects, in turn, represent the individual cells of a row. To retrieve an individual cell, first get the HtmlTableRow object that represents the row containing the cell in the table (from the Rows collection of the HtmlTable control). You can then get the HtmlTableCell object that represents the cell in the row (from the Cells collection of the HtmlTableRow object).

The following code example demonstrates how to dynamically generate the contents of an HtmlTable control by adding cells to an HtmlTableCellCollection collection. Notice that the Cells property of a row, represented by an HtmlTableRow object, is the HtmlTableCellCollection collection.

<%@ Page Language="C#" AutoEventWireup="True" %>

<!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)
  {

    // Get the number of rows and columns selected by the user.
    int numrows = Convert.ToInt32(Select1.Value);
    int numcells = Convert.ToInt32(Select2.Value);

    // Iterate through the rows.
    for (int j = 0; j < numrows; j++)
    {

      // Create a new row and add it to the Rows collection.
      HtmlTableRow row = new HtmlTableRow();

      // Provide a different background color for alternating rows.
      if (j % 2 == 1)
        row.BgColor = "Gray";

      // Iterate through the cells of a row.
      for (int i = 0; i < numcells; i++)
      {
        // Create a new cell and add it to the Cells collection.
        HtmlTableCell cell = new HtmlTableCell();
        cell.Controls.Add(new LiteralControl("row " +
                          j.ToString() +
                          ", cell " +
                          i.ToString()));
        row.Cells.Add(cell);
      }
      Table1.Rows.Add(row);
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
   <title>HtmlTableCellCollection Example</title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>HtmlTableCellCollection Example</h3>

      <table id="Table1" 
             style="border-width:1; border-color:Black; padding:5"
             cellspacing="0" 
             runat="server"/>

      <hr />

      Select the number of rows and columns to create: <br /><br />

      Table rows:
      <select id="Select1" 
              runat="server">

         <option value="1">1</option>
         <option value="2">2</option>
         <option value="3">3</option>
         <option value="4">4</option>
         <option value="5">5</option>

      </select>

      &nbsp;&nbsp;

      Table cells:
      <select id="Select2" 
              runat="server">

         <option value="1">1</option>
         <option value="2">2</option>
         <option value="3">3</option>
         <option value="4">4</option>
         <option value="5">5</option>

      </select>

      <br /><br />

      <input type="submit" 
             value="Generate Table" 
             runat="server"/>

   </form>

</body>
</html>

.NET Framework
Available since 1.1

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show:
© 2016 Microsoft