This documentation is archived and is not being maintained.
TableRowCollection.Clear Method
.NET Framework 1.1
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
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
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: