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 Sub New (
	tagName As String
)

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.

System_CAPS_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="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 Page_Load(ByVal sender As Object, ByVal e As EventArgs)

    ' Create an instance of an HtmlTable control.
    Dim table As HtmlTable = New HtmlTable()
    table.Border = 1
    table.CellPadding = 3

    ' Populate the HtmlTable control by adding rows to it.
    Dim rowcount As Integer
    Dim cellcount As Integer

    ' Create the rows of the table.
    For rowcount = 0 To 4

      ' Create a new HtmlTableRow control.
      Dim row As HtmlTableRow = New HtmlTableRow()

      ' Add cells to the HtmlTableRow control. 
      For cellcount = 0 To 3

        ' Define a new HtmlTableCell control.
        Dim cell As HtmlTableCell

        ' Create table header cells for the first row.
        If rowcount <= 0 Then

          cell = New HtmlTableCell("th")

        Else

          cell = New HtmlTableCell()

        End If

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

      Next cellcount

      ' Add the row to the HtmlTable Rows collection.
      table.Rows.Add(row)

    Next rowcount

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

  End Sub

</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
Available since 1.1
Return to top
Show: