HtmlTableCell Constructors
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.
Initializes a new instance of the HtmlTableCell class.
Overloads
| HtmlTableCell() |
Initializes a new instance of the HtmlTableCell class using default values. |
| HtmlTableCell(String) |
Initializes a new instance of the HtmlTableCell class, using the specified tag name. |
HtmlTableCell()
Initializes a new instance of the HtmlTableCell class using default values.
public:
HtmlTableCell();public HtmlTableCell ();Public Sub New ()Examples
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 parameterless constructor is used to create a <td> element, while its overloaded constructor that takes a string parameter is used with the literal string "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>
<%@ 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>
Remarks
Use this constructor to create and initialize a new instance of the HtmlTableCell class. This constructor is used to create an HtmlTableCell object that represents the <td> element for a table data cell.
The following table shows the initial property value for an instance of HtmlTableCell.
| Property | Initial Value |
|---|---|
| TagName | The "td" literal string. |
See also
Applies to
HtmlTableCell(String)
Initializes a new instance of the HtmlTableCell class, using the specified tag name.
public:
HtmlTableCell(System::String ^ tagName);public HtmlTableCell (string tagName);new System.Web.UI.HtmlControls.HtmlTableCell : string -> System.Web.UI.HtmlControls.HtmlTableCellPublic Sub New (tagName As String)Parameters
- tagName
- String
The element name of the tag.
Examples
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 parameterless 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>
<%@ 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>
Remarks
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 parameterless constructor.
Note
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. |
