HtmlTableCellCollection.Clear Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Removes all HtmlTableCell objects from the HtmlTableCellCollection collection.
public:
void Clear();public void Clear ();member this.Clear : unit -> unitPublic Sub Clear ()Examples
The following code example demonstrates how to use the Clear method to remove all items from the HtmlTableCellCollection collection. New entries are then added to the collection and displayed in the HtmlTable control.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Button_Click(Object sender, EventArgs e)
{
// Clear the cells from the first row and remove the
// row from the table.
Table1.Rows[0].Cells.Clear();
Table1.Rows.RemoveAt(0);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTableCellCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTableCellCollection Example</h3>
<table id="Table1"
style="border-width:1; border-color:Black"
runat="server">
<tr>
<td>
Cell 1
</td>
<td>
Cell 2
</td>
</tr>
<tr>
<td>
Cell 3
</td>
<td>
Cell 4
</td>
</tr>
</table>
<br /><br />
<input type="button"
value="Remove First Row from Table"
onserverclick="Button_Click"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs)
' Clear the cells from the first row and remove the
' row from the table.
Table1.Rows(0).Cells.Clear()
Table1.Rows.RemoveAt(0)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTableCellCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTableCellCollection Example</h3>
<table id="Table1"
style="border-width:1; border-color:Black"
runat="server">
<tr>
<td>
Cell 1
</td>
<td>
Cell 2
</td>
</tr>
<tr>
<td>
Cell 3
</td>
<td>
Cell 4
</td>
</tr>
</table>
<br /><br />
<input type="button"
value="Remove First Row from Table"
onserverclick="Button_Click"
runat="server"/>
</form>
</body>
</html>
Remarks
Use this method to remove all HtmlTableCell objects from the HtmlTableCellCollection collection and reset the Count property to 0.
Note
This method removes the cells from a row, but it does not remove the row from the table. To remove a row from the table, be sure to also remove the HtmlTableRow object that represents the row from the Rows collection of the HtmlTable control.
