This documentation is archived and is not being maintained.

TableRowCollection.Clear Method

Removes all TableRow controls from the TableRowCollection.

[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 TableRow objects from the TableRowCollection and set the Count property to 0.

Example

[Visual Basic, C#] The following example demonstrates how to use the Clear method to remove all TableRow objects from the TableRowCollection of the table and replace them with new TableRow 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)
            
            ' Clear the table.
            Table1.Rows.Clear()
            
            ' Create a new 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 = "***"
                    r.Cells.Add(c)
                Next i
                Table1.Rows.Add(r)
            Next j
        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 All Rows 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) {
          
          // Clear the table.
          Table1.Rows.Clear();
 
          // Create a new 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="***";
                r.Cells.Add(c);
             }
             Table1.Rows.Add(r);
          }
 
       }
 
    </script>
 
 </head>
 
 <body>
 
    <h3>TableCellCollection Example</h3>
    <form runat=server>
       <asp:Table id="Table1" 
            runat="server"/>
  
       <br>
 
       <center>
          <asp:Button id="Button1"
               Text="Replace All Rows 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

TableRowCollection Class | TableRowCollection Members | System.Web.UI.WebControls Namespace | TableRow | Count

Show: