HtmlTableCell Constructor (String)
Collapse the table of content
Expand the table of content

HtmlTableCell Constructor (String)


Initializes a new instance of the HtmlTableCell class, using the specified tag name.

Namespace:   System.Web.UI.HtmlControls
Assembly:  System.Web (in System.Web.dll)

public HtmlTableCell(
	string tagName


Type: System.String

The element name of the tag.

Use this constructor to create and initialize a new instance of the HtmlTableCell class. It allows you to create an HtmlTableCell object that represents a cell in an HtmlTable control. It is commonly used to create an HtmlTableCell object that represents a <th> element for a table heading cell. Although you can use this constructor to create a <td> element for a table data cell, you typically use the default constructor.


Although this constructor allows you to specify the cell element to create, the <th> element is the only supported cell element. For future compatibility, this constructor allows you to create other HTML cell elements that could become available.

The following table shows the initial property value for an instance of HtmlTableCell.


Initial Value


The value of the tagName parameter.

The following code example demonstrates how to create an instance of an HtmlTable control with HtmlTableCell controls and place the table on the Web page. Note how the HtmlTableCell control's default constructor is used to create a <td> element, while its overloaded constructor that takes a string parameter is used with the literal "th" to create a <th> element.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<script runat="server" >

  void Page_Load(Object sender, EventArgs e)

    // Create an instance of an HtmlTable control.
    HtmlTable table = new HtmlTable();
    table.Border = 1;
    table.CellPadding = 3;

    // Populate the HtmlTable control by adding rows to it. 
    for (int rowcount = 0; rowcount < 5; rowcount++)
      // Create a new HtmlTableRow control.
      HtmlTableRow row = new HtmlTableRow();

      // Add cells to the HtmlTableRow control.
      for (int cellcount = 0; cellcount < 4; cellcount++)
        // Define a new HtmlTableCell control.
        HtmlTableCell cell;

        // Create table header cells for the first row.
        if (rowcount <= 0)
          cell = new HtmlTableCell("th");
          cell = new HtmlTableCell();

        // Create the text for the cell.
        cell.Controls.Add(new LiteralControl(
          "row " + rowcount.ToString() + ", " +
          "column " + cellcount.ToString()));

        // Add the cell to the HtmlTableRow Cells collection. 


      // Add the row to the HtmlTable Rows collection.


    // Add the control to the Controls collection of the 
    // PlaceHolder control.



<html xmlns="" >
   <title>HtmlTable Example</title>

   <form id="form1" runat="server">

      <h3> HtmlTable Example </h3> 

      <asp:PlaceHolder id="Place" 



.NET Framework
Available since 1.1
Return to top
© 2016 Microsoft