HtmlTableCellCollection.Remove(HtmlTableCell) Method

Reference

Definition

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Removes the specified HtmlTableCell object from the HtmlTableCellCollection collection.

public:
 void Remove(System::Web::UI::HtmlControls::HtmlTableCell ^ cell);

public void Remove (System.Web.UI.HtmlControls.HtmlTableCell cell);

member this.Remove : System.Web.UI.HtmlControls.HtmlTableCell -> unit

Public Sub Remove (cell As HtmlTableCell)

Parameters

cell: HtmlTableCell

The HtmlTableCell to remove from the HtmlTableCellCollection.

Examples

The following code example demonstrates how to use the Remove method to remove the specified cell of a table, represented by an HtmlTableCell object, 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.
      HtmlTableCell cell = Table1.Rows[i].Cells[0];
      Table1.Rows[i].Cells.Remove(cell);

    }

  }

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

<%@ Page Language="VB" 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">

  Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs)

    Dim i As Integer
    Dim cell As HtmlTableCell

    ' Iterate through the rows of the table.
    For i = 0 To Table1.Rows.Count - 1
 
      ' Remove the cells from the first column.
      cell = Table1.Rows(i).Cells(0)
      Table1.Rows(i).Cells.Remove(cell)

    Next i

  End Sub

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

Remarks

Use this method to remove the specified HtmlTableCell object from the HtmlTableCellCollection collection.

Note

If you specify an HtmlTableCell object that does not exist in the HtmlTableCellCollection collection, no item is removed from the collection.

Applies to

Share via