This documentation is archived and is not being maintained.

TableCellCollection.Clear Method

Removes all TableCell objects from the TableCellCollection.

[Visual Basic]
Public Overridable Sub Clear() Implements IList.Clear
[C#]
public virtual void Clear();
[C++]
public: virtual void Clear();
[JScript]
public function Clear();

Implements

IList.Clear

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.

Example

[Visual Basic, C#] 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.

[Visual Basic] 
<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
 <head>
 
    <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 j As Integer
            For j = 0 To numrows - 1
                Dim r As New TableRow()
                Dim i As Integer
                For i = 0 To numcells - 1
                    Dim c As New TableCell()
                    c.Text = counter.ToString()
                    counter += 1
                    r.Cells.Add(c)
                Next i
                Table1.Rows.Add(r)
            Next j
        End Sub         

        Sub Button_Click(sender As Object, e As EventArgs)
            
            Table1.Rows(2).Cells.Clear()
            Dim i As Integer
            For i = 0 To numcells - 1
                Dim c As New TableCell()
                c.Text = "***"
                Table1.Rows(2).Cells.Add(c)
            Next i
        End Sub
 
    </script>
 
 </head>
 
 <body>
 
    <h3>TableCellCollection Example</h3>
    <form runat=server>
       <asp:Table id="Table1"
            runat="server"/>
  
       <br>
 
       <center>
          <asp:Button id="Button1"
               Text="Replace Row 3 With ***"
               OnClick="Button_Click"
               runat="server"/>
       </center>
    </form>
 
 </body>
 </html>
 

[C#] 
<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
 <head>
 
    <script runat="server">
 
       int numrows = 5;
       int numcells = 6;
       int counter = 1;
 
       void Page_Load(Object sender, EventArgs e) 
       {
          
          // Create a table.
          for (int j=0; j<numrows; j++) 
          {          
             TableRow r = new TableRow();
             for (int i=0; i<numcells; i++) 
             {
                TableCell c = new TableCell();
                c.Text=counter.ToString();
                counter++;
                r.Cells.Add(c);
             }
             Table1.Rows.Add(r);
          }
 
       }
 
       void Button_Click(Object sender, EventArgs e) {
          
          Table1.Rows[2].Cells.Clear();
          for (int i=0; i<numcells; i++) 
          {
             TableCell c = new TableCell();
             c.Text="***";
             Table1.Rows[2].Cells.Add(c); 
          }
 
       }
 
    </script>
 
 </head>
 
 <body>
 
    <h3>TableCellCollection Example</h3>
    <form runat=server>
       <asp:Table id="Table1"
            runat="server"/>
  
       <br>
 
       <center>
          <asp:Button id="Button1"
               Text="Replace Row 3 With ***"
               OnClick="Button_Click"
               runat="server"/>
       </center>
    </form>
 
 </body>
 </html>
 

[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family

See Also

TableCellCollection Class | TableCellCollection Members | System.Web.UI.WebControls Namespace | TableCell | TableRow | Cells | Count

Show: