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
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
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