Edit

TableCellCollection.Clear Method

  • Reference

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Removes all TableCell objects from the TableCellCollection.

public:
 virtual void Clear();
public void Clear ();
abstract member Clear : unit -> unit
override this.Clear : unit -> unit
Public Sub Clear ()

Implements

Clear()

Examples

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>

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

    Dim numrows As Integer = 5
    Dim numcells As Integer = 6
    Dim counter As Integer = 1

    Sub Page_Load(sender As Object, e As EventArgs)
        ' Create a table.
        Dim rowNum As Integer
        For rowNum = 0 To numrows - 1
            Dim rw As New TableRow()
            Dim cellNum As Integer
            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         

    Sub Button_Click(sender As Object, e As EventArgs)
        Table1.Rows(2).Cells.Clear()
        Dim cellNum As Integer
        For cellNum = 0 To numcells - 1
            Dim cel As New TableCell()
            cel.Text = "***"
            Table1.Rows(2).Cells.Add(cel)
        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" />
    <p>&nbsp;</p>
    <asp:Button id="Button1"
         Text="Replace Row 3 With ***"
         OnClick="Button_Click"
         runat="server" />

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

Remarks

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

Note

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.

Applies to

See also