HtmlTable 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
允许在服务器上对 HTML <table> 元素进行编程访问。
public ref class HtmlTable : System::Web::UI::HtmlControls::HtmlContainerControlpublic class HtmlTable : System.Web.UI.HtmlControls.HtmlContainerControltype HtmlTable = class
inherit HtmlContainerControlPublic Class HtmlTable
Inherits HtmlContainerControl- 继承
示例
下面的代码示例演示如何使用 控件 HtmlTable 在表中显示信息。
<%@ 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)
{
// Set the properties of the HtmlTable with the
// user selections.
Table1.BgColor = BgColorSelect.Value;
Table1.Border = Convert.ToInt32(BorderSelect.Value);
Table1.BorderColor = BorderColorSelect.Value;
Table1.Height = HeightSelect.Value;
Table1.Width = WidthSelect.Value;
}
</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>
<table id="Table1"
style="border-width:1; border-color:Black"
runat="server">
<tr>
<th>
Column 1
</th>
<th>
Column 2
</th>
<th>
Column 3
</th>
</tr>
<tr>
<td>
Cell 1
</td>
<td>
Cell 2
</td>
<td>
Cell 3
</td>
</tr>
<tr>
<td>
Cell 4
</td>
<td>
Cell 5
</td>
<td>
Cell 6
</td>
</tr>
</table>
<hr />
Select the display settings: <br /><br />
BgColor:
<select id="BgColorSelect"
runat="server">
<option value="Red">Red</option>
<option value="Blue">Blue</option>
<option value="Green">Green</option>
<option value="Black">Black</option>
<option value="White" selected="selected">White</option>
</select>
Border:
<select id="BorderSelect"
runat="server">
<option value="0">0</option>
<option value="1" selected="selected">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
</select>
BorderColor:
<select id="BorderColorSelect"
runat="server">
<option value="Red">Red</option>
<option value="Blue">Blue</option>
<option value="Green">Green</option>
<option value="Black" selected="selected">Black</option>
<option value="White">White</option>
</select>
<br /><br />
Height:
<select id="HeightSelect"
runat="server">
<option value="0">0</option>
<option value="100">100</option>
<option value="150">150</option>
<option value="200">200</option>
<option value="250">250</option>
</select>
Width:
<select id="WidthSelect"
runat="server">
<option value="0">0</option>
<option value="200">200</option>
<option value="250">250</option>
<option value="300">300</option>
<option value="350">350</option>
</select>
<br /><br />
<input type="button"
value="Generate 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)
' Set the properties of the HtmlTable with the
' user selections.
Table1.BgColor = BgColorSelect.Value
Table1.Border = CInt(BorderSelect.Value)
Table1.BorderColor = BorderColorSelect.Value
Table1.Height = HeightSelect.Value
Table1.Width = WidthSelect.Value
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>
<table id="Table1"
style="border-width:1; border-color:Black"
runat="server">
<tr>
<th>
Column 1
</th>
<th>
Column 2
</th>
<th>
Column 3
</th>
</tr>
<tr>
<td>
Cell 1
</td>
<td>
Cell 2
</td>
<td>
Cell 3
</td>
</tr>
<tr>
<td>
Cell 4
</td>
<td>
Cell 5
</td>
<td>
Cell 6
</td>
</tr>
</table>
<hr />
Select the display settings: <br /><br />
BgColor:
<select id="BgColorSelect"
runat="server">
<option value="Red">Red</option>
<option value="Blue">Blue</option>
<option value="Green">Green</option>
<option value="Black">Black</option>
<option value="White" selected="selected">White</option>
</select>
Border:
<select id="BorderSelect"
runat="server">
<option value="0">0</option>
<option value="1" selected="selected">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
</select>
BorderColor:
<select id="BorderColorSelect"
runat="server">
<option value="Red">Red</option>
<option value="Blue">Blue</option>
<option value="Green">Green</option>
<option value="Black" selected="selected">Black</option>
<option value="White">White</option>
</select>
<br /><br />
Height:
<select id="HeightSelect"
runat="server">
<option value="0">0</option>
<option value="100">100</option>
<option value="150">150</option>
<option value="200">200</option>
<option value="250">250</option>
</select>
Width:
<select id="WidthSelect"
runat="server">
<option value="0">0</option>
<option value="200">200</option>
<option value="250">250</option>
<option value="300">300</option>
<option value="350">350</option>
</select>
<br /><br />
<input type="button"
value="Generate Table"
onserverclick ="Button_Click"
runat="server"/>
</form>
</body>
</html>
下面的代码示例演示如何动态创建控件 HtmlTable 。
<%@ Page Language="C#" %>
<!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)
{
// Get the number of rows and columns selected by the user.
int numrows = Convert.ToInt32(Select1.Value);
int numcells = Convert.ToInt32(Select2.Value);
// Iterate through the rows.
for (int j = 0; j < numrows; j++)
{
// Create a new row and add it to the Rows collection.
HtmlTableRow row = new HtmlTableRow();
// Provide a different background color for alternating rows.
if (j % 2 == 1)
row.BgColor = "Gray";
// Iterate through the cells of a row.
for (int i = 0; i < numcells; i++)
{
// Create a new cell and add it to the HtmlTableRow
// Cells collection.
HtmlTableCell cell = new HtmlTableCell();
cell.Controls.Add(new LiteralControl("row " +
j.ToString() +
", cell " +
i.ToString()));
row.Cells.Add(cell);
}
// Add the row to the HtmlTable Rows collection.
Table1.Rows.Add(row);
}
}
</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>
<table id="Table1"
style="border-width:1; border-color:Black; padding:5"
cellspacing="0"
runat="server"/>
<hr />
Select the number of rows and columns to create: <br /><br />
Table rows:
<select id="Select1"
runat="server">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
</select>
Table cells:
<select id="Select2"
runat="server">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
</select>
<br /><br />
<input type="submit"
value="Generate Table"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!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)
Dim i As Integer
Dim j As Integer
Dim row As HtmlTableRow
Dim cell As HtmlTableCell
' Get the number of rows and columns selected by the user.
Dim numrows As Integer = CInt(Select1.Value)
Dim numcells As Integer = CInt(Select2.Value)
' Iterate through the rows.
For j = 0 To numrows - 1
' Create a new row.
row = New HtmlTableRow()
' Provide a different background color for alternating rows.
If (j Mod 2) = 1 Then
row.BgColor = "Gray"
End If
' Iterate through the cells of a row.
For i = 0 To numcells - 1
' Create a new cell and add it to the HtmlTableRow
' Cells collection.
cell = New HtmlTableCell()
cell.Controls.Add(New LiteralControl("row " & _
j.ToString() & _
", cell " & _
i.ToString()))
row.Cells.Add(cell)
Next i
' Add the row to the HtmlTable Rows collection.
Table1.Rows.Add(row)
Next j
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>
<table id="Table1"
style="border-width:1; border-color:Black; padding:5"
cellspacing="0"
runat="server"/>
<hr />
Select the number of rows and columns to create: <br /><br />
Table rows:
<select id="Select1"
runat="server">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
</select>
Table cells:
<select id="Select2"
runat="server">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
</select>
<br /><br />
<input type="submit"
value="Generate Table"
runat="server"/>
</form>
</body>
</html>
注解
HtmlTable使用 控件以编程方式控制服务器上的 HTML <table> 元素。 这样就可以在网页上创建表。
可以通过设置 BgColor、、Border、 BorderColorHeight和 Width 属性来动态更改元素的外观<table>。 还可以通过设置 Align、 CellPadding和 CellSpacing 属性来控制单元格内容的显示方式。
控件的 HtmlTable 行存储在 控件的 属性中 Rows 。 这样，就可以以编程方式访问表的各个行。
注意
不支持复杂表模型。 不能有一个HtmlTable包含嵌套 <caption>、、<col>、<thead><colgroup><tbody>、 或 <tfoot> 元素的控件。 这些元素在未发出警告的情况下被删除，并且不会显示在输出 HTML 中。 如果尝试以编程方式将这些表模型元素添加到控件的HtmlTable集合，Control.Controls则会引发异常。
有关 实例 HtmlTable的初始属性值列表， HtmlTable 请参阅 构造函数。
构造函数
| HtmlTable() |
初始化 HtmlTable 类的新实例。 |
属性
| Adapter |
获取控件的浏览器特定适配器。 (继承自 Control) |
| Align |
获取或设置 HtmlTable 控件相对于网页上其他元素的对齐方式。 |
| AppRelativeTemplateSourceDirectory |
获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。 (继承自 Control) |
| Attributes |
获取在 ASP.NET 页内的服务器控件标记上表示的所有特性名称和值对的集合。 (继承自 HtmlControl) |
| BgColor |
获取或设置 HtmlTable 控件的背景色。 |
| BindingContainer |
获取包含该控件的数据绑定的控件。 (继承自 Control) |
| Border |
获取或设置 HtmlTable 控件的边框宽度（以像素为单位）。 |
| BorderColor |
获取或设置 HtmlTable 控件的边框颜色。 |
| CellPadding |
获取或设置 HtmlTable 控件中单元格内容和单元格边框之间的间距（以像素为单位）。 |
| CellSpacing |
获取或设置 HtmlTable 控件中相邻单元格之间的间距（以像素为单位）。 |
| ChildControlsCreated |
获取一个值，该值指示是否已创建服务器控件的子控件。 (继承自 Control) |
| ClientID |
获取由 ASP.NET 生成的 HTML 标记的控件 ID。 (继承自 Control) |
| ClientIDMode |
获取或设置用于生成 ClientID 属性值的算法。 (继承自 Control) |
| ClientIDSeparator |
获取一个字符值，该值表示 ClientID 属性中使用的分隔符字符。 (继承自 Control) |
| Context |
为当前 Web 请求获取与服务器控件关联的 HttpContext 对象。 (继承自 Control) |
| Controls |
获取 ControlCollection 对象，该对象表示 UI 层次结构中的指定服务器控件的子控件。 (继承自 Control) |
| DataItemContainer |
如果命名容器实现 IDataItemContainer，则获取对命名容器的引用。 (继承自 Control) |
| DataKeysContainer |
如果命名容器实现 IDataKeysControl，则获取对命名容器的引用。 (继承自 Control) |
| DesignMode |
获取一个值，该值指示是否正在使用设计图面上的一个控件。 (继承自 Control) |
| Disabled |
获取或设置一个值，该值指示 HTML 服务器控件是否被禁用。 (继承自 HtmlControl) |
| EnableTheming |
获取或设置一个值，该值指示主题是否应用于该控件。 (继承自 Control) |
| EnableViewState |
获取或设置一个值，该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。 (继承自 Control) |
| Events |
获取控件的事件处理程序委托列表。 此属性为只读。 (继承自 Control) |
| HasChildViewState |
获取一个值，该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。 (继承自 Control) |
| Height |
获取或设置 HtmlTable 控件的高度。 |
| ID |
获取或设置分配给服务器控件的编程标识符。 (继承自 Control) |
| IdSeparator |
获取用于分隔控件标识符的字符。 (继承自 Control) |
| InnerHtml |
获取或设置控件的开始标记和结束标记之间的内容，但不自动将特殊字符转换为等效的 HTML 实体。 此控件不支持该属性。 |
| InnerText |
获取或设置控件的开始标记和结束标记之间的内容，并自动将特殊字符转换为等效的 HTML 实体。 此控件不支持该属性。 |
| IsChildControlStateCleared |
获取一个值，该值指示该控件中包含的控件是否具有控件状态。 (继承自 Control) |
| IsTrackingViewState |
获取一个值，用于指示服务器控件是否会将更改保存到其视图状态中。 (继承自 Control) |
| IsViewStateEnabled |
获取一个值，该值指示是否为该控件启用了视图状态。 (继承自 Control) |
| LoadViewStateByID |
获取一个值，该值指示控件是否通过 ID 而不是索引参与加载其视图状态。 (继承自 Control) |
| NamingContainer |
获取对服务器控件的命名容器的引用，此引用创建唯一的命名空间，以区分具有相同 ID 属性值的服务器控件。 (继承自 Control) |
| Page |
获取对包含服务器控件的 Page 实例的引用。 (继承自 Control) |
| Parent |
获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 Control) |
| RenderingCompatibility |
获取一个值，该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。 (继承自 Control) |
| Rows |
获取包含 HtmlTableRowCollection 控件中的所有行的 HtmlTable 集合。 |
| Site |
获取容器信息，该容器在呈现于设计图面上时承载当前控件。 (继承自 Control) |
| SkinID |
获取或设置要应用于控件的外观。 (继承自 Control) |
| Style |
获取应用于 ASP.NET 文件中指定的 HTML 服务器控件的所有级联样式表 (CSS) 属性的集合。 (继承自 HtmlControl) |
| TagName |
获取包含 |
| TemplateControl |
获取或设置对包含该控件的模板的引用。 (继承自 Control) |
| TemplateSourceDirectory |
获取包含当前服务器控件的 Page 或 UserControl 的虚拟目录。 (继承自 Control) |
| UniqueID |
获取服务器控件的唯一的、以分层形式限定的标识符。 (继承自 Control) |
| ValidateRequestMode |
获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。 (继承自 Control) |
| ViewState |
获取状态信息的字典，这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。 (继承自 Control) |
| ViewStateIgnoresCase |
获取一个值，该值指示 HtmlControl 视图状态是否区分大小写。 (继承自 HtmlControl) |
| ViewStateMode |
获取或设置此控件的视图状态模式。 (继承自 Control) |
| Visible |
获取或设置一个值，该值指示服务器控件是否作为 UI 呈现在页上。 (继承自 Control) |
| Width |
获取或设置 HtmlTable 控件的宽度。 |
方法
事件
| DataBinding |
当服务器控件绑定到数据源时发生。 (继承自 Control) |
| Disposed |
当从内存释放服务器控件时发生，这是请求 ASP.NET 页时服务器控件生存期的最后阶段。 (继承自 Control) |
| Init |
当服务器控件初始化时发生；初始化是控件生存期的第一步。 (继承自 Control) |
| Load |
当服务器控件加载到 Page 对象中时发生。 (继承自 Control) |
| PreRender |
在加载 Control 对象之后、呈现之前发生。 (继承自 Control) |
| Unload |
当服务器控件从内存中卸载时发生。 (继承自 Control) |
显式接口实现
扩展方法
| FindDataSourceControl(Control) |
返回与指定控件的数据控件关联的数据源。 |
| FindFieldTemplate(Control, String) |
返回指定控件的命名容器中指定列的字段模板。 |
| FindMetaTable(Control) |
返回包含数据控件的元表对象。 |
