HtmlTableCellCollection.RemoveAt Method (Int32)

 

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

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

public void RemoveAt(
	int index
)

Parameters

index
Type: System.Int32

The index of the HtmlTableCell to remove from the HtmlTableCellCollection.

Exception Condition
ArgumentOutOfRangeException

The specified index is outside the range of index values in the collection.

Use this method to remove the HtmlTableCell object at the specified index from an HtmlTableCellCollection collection. The index number is zero-based; therefore, the first item in the collection has an index value of 0.

System_CAPS_noteNote

If you specify an index that is outside the range of index values, an exception is raised.

The following code example demonstrates how to use the RemoveAt method to remove the item at the specified index from the HtmlTableCellCollection collection. This example removes the cells from the first column of the HtmlTable control.

<%@ 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 Button_Click(Object sender, EventArgs e)
  {

    // Iterate through the rows of the table.
    for (int i = 0; i <= Table1.Rows.Count - 1; i++)
    {

      // Remove the cells from the first column.
      Table1.Rows[i].Cells.RemoveAt(0);

    }

  }

</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"
             runat="server">

         <tr>
            <td>
               Cell 1
            </td>
            <td>
               Cell 2
            </td>
         </tr>
         <tr>
            <td>
               Cell 3
            </td>
            <td>
               Cell 4
            </td>
         </tr>

      </table>

      <br /><br />

      <input type="button" 
             value="Remove First Column from Table"
             onserverclick="Button_Click" 
             runat="server"/>

   </form>

</body>
</html>

.NET Framework
Available since 1.1
Return to top
Show: