Export (0) Print
Expand All

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
)

Parameters

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.

NoteNote

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.

Property

Initial Value

TagName

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"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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");
        }
        else
        {
          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. 
        row.Cells.Add(cell);

      }

      // Add the row to the HtmlTable Rows collection.
      table.Rows.Add(row);

    }

    // Add the control to the Controls collection of the 
    // PlaceHolder control.
    Place.Controls.Clear();
    Place.Controls.Add(table);

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
   <title>HtmlTable Example</title>
</head>
<body>

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

      <h3> HtmlTable Example </h3> 

      <asp:PlaceHolder id="Place" 
                       runat="server"/>

   </form>

</body>
</html>
 

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft