TableCellCollection.Clear Method ()

 

Removes all TableCell objects from the TableCellCollection.

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

Public Sub 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="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>

.NET Framework
Available since 1.1
Return to top
Show: