TableCellCollection.Clear Method ()

 

Removes all TableCell objects from the TableCellCollection.

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

public void Clear()

Implements

IList.Clear()

Use this method to remove all TableCell objects from the TableCellCollection and set the Count property to 0.

System_CAPS_noteNote

This method removes the TableCell objects from the TableCellCollection, but it does not remove the TableRow from the Table control. Be sure to also remove the TableRow if you want to completely remove a row from the table.

The following example demonstrates how to use the Clear method to remove all TableCell objects from the center row of the table and replace them with new TableCell objects.

<%@ 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">

    int numrows = 5;
    int numcells = 6;
    int counter = 1;

    private void Page_Load(Object sender, EventArgs e) 
    {
        // Create a table.
        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(Object sender, EventArgs e)
    {
        Table1.Rows[2].Cells.Clear();
        for (int cellNum = 0; cellNum < numcells; cellNum++) 
        {
            TableCell cel = new TableCell();
            cel.Text="***";
            Table1.Rows[2].Cells.Add(cel); 
        }
    }

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

    <asp:Button id="Button1"
         Text="Replace Row 3 With ***"
         OnClick="Button_Click"
         runat="server" />

    </div>
    </form>
</body>
</html>

.NET Framework
Available since 1.1
Return to top
Show: