TableHeaderRow 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示 Table 控件的标题行。
public ref class TableHeaderRow : System::Web::UI::WebControls::TableRowpublic class TableHeaderRow : System.Web.UI.WebControls.TableRowtype TableHeaderRow = class
inherit TableRowPublic Class TableHeaderRow
Inherits TableRow- 继承
示例
下面的代码示例演示了用于创建 Table 具有 TableHeaderRow 和 的控件的 TableFooterRow声明性语法。
<%@ page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>TableHeaderRow-TableFooterRow Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>TableHeaderRow and TableFooterRow Example</h3>
<asp:Table id="Table1" runat="server"
CellPadding="3"
CellSpacing="0"
GridLines="both"
Caption="Sample Table">
<asp:TableHeaderRow id="Table1HeaderRow"
BackColor="LightBlue"
runat="server">
<asp:TableHeaderCell
Scope="Column"
Text="Col1" />
<asp:TableHeaderCell
Scope="Column"
Text="Col2" />
<asp:TableHeaderCell
Scope="Column"
Text="Col3" />
</asp:TableHeaderRow>
<asp:TableRow>
<asp:TableCell Text="(0,0)" />
<asp:TableCell Text="(0,1)" />
<asp:TableCell Text="(0,2)" />
</asp:TableRow>
<asp:TableRow>
<asp:TableCell Text="(1,0)" />
<asp:TableCell Text="(1,1)" />
<asp:TableCell Text="(1,2)" />
</asp:TableRow>
<asp:TableFooterRow runat="server"
BackColor="LightBlue">
<asp:TableCell
ColumnSpan="3"
Text="The footer row." />
</asp:TableFooterRow>
</asp:Table>
</div>
</form>
</body>
</html>
下面的代码示例演示如何以编程方式创建 Table 具有 TableHeaderRow 和 的 TableFooterRow控件。
注意
下面的代码示例使用单文件代码模型，如果直接复制到代码隐藏文件中，可能无法正常工作。 必须将此代码示例复制到扩展名为 .aspx 的空文本文件中。 有关 Web 窗体代码模型的详细信息，请参阅 ASP.NET Web 窗体页代码模型。
<%@ page language="C#" %>
<%@ Import Namespace="System.Drawing" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
private void Page_Load(object sender, EventArgs e)
{
// Add rows to the table.
for (int rowNum = 0; rowNum < 100; rowNum++)
{
TableRow tempRow = new TableRow();
for (int cellNum = 0; cellNum < 4; cellNum++)
{
TableCell tempCell = new TableCell();
tempCell.Text =
String.Format("({0},{1})", rowNum, cellNum);
tempRow.Cells.Add(tempCell);
}
Table1.Rows.Add(tempRow);
}
// Create a TableHeaderRow.
TableHeaderRow headerRow = new TableHeaderRow();
headerRow.BackColor = Color.LightBlue;
// Create TableCell objects to contain
// the text for the header.
TableHeaderCell headerTableCell1 = new TableHeaderCell();
TableHeaderCell headerTableCell2 = new TableHeaderCell();
TableHeaderCell headerTableCell3 = new TableHeaderCell();
headerTableCell1.Text = "Column 1 Header";
headerTableCell1.Scope = TableHeaderScope.Column;
headerTableCell1.AbbreviatedText = "Col 1 Head";
headerTableCell2.Text = "Column 2 Header";
headerTableCell2.Scope = TableHeaderScope.Column;
headerTableCell2.AbbreviatedText = "Col 2 Head";
headerTableCell3.Text = "Column 3 Header";
headerTableCell3.Scope = TableHeaderScope.Column;
headerTableCell3.AbbreviatedText = "Col 3 Head";
// Add the TableHeaderCell objects to the Cells
// collection of the TableHeaderRow.
headerRow.Cells.Add(headerTableCell1);
headerRow.Cells.Add(headerTableCell2);
headerRow.Cells.Add(headerTableCell3);
// Add the TableHeaderRow as the first item
// in the Rows collection of the table.
Table1.Rows.AddAt(0, headerRow);
// Create a TableFooterRow.
TableFooterRow footerRow = new TableFooterRow();
footerRow.BackColor = Color.LightBlue;
// Create TableCell objects to contain the
// text for the footer.
TableCell footerTableCell1 = new TableCell();
TableCell footerTableCell2 = new TableCell();
TableCell footerTableCell3 = new TableCell();
footerTableCell1.Text = "Column 1 footer";
footerTableCell2.Text = "Column 2 footer";
footerTableCell3.Text = "Column 3 footer";
// Add the TableCell objects to the Cells
// collection of the TableFooterRow.
footerRow.Cells.Add(footerTableCell1);
footerRow.Cells.Add(footerTableCell2);
footerRow.Cells.Add(footerTableCell3);
// Add the TableFooterRow to the Rows
// collection of the table.
Table1.Rows.Add(footerRow);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>TableHeaderRow Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>TableHeaderRow and TableFooterRow Example</h3>
<asp:table id="Table1"
CellPadding="3"
CellSpacing="0"
Gridlines="Both"
runat="server">
</asp:table>
</div>
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ Import Namespace="System.Drawing" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Private Sub Page_Load(ByVal sender As Object, _
ByVal e As System.EventArgs)
' Add rows to the table.
Dim rowNum As Integer
For rowNum = 0 To 100
Dim tempRow As New TableRow
Dim cellNum As Integer
For cellNum = 0 To 2
Dim tempCell As New TableCell
tempCell.Text = _
String.Format("({0},{1})", rowNum, cellNum)
tempRow.Cells.Add(tempCell)
Next
Table1.Rows.Add(tempRow)
Next
' Create a TableHeaderRow.
Dim headerRow As New TableHeaderRow
headerRow.BackColor = Color.LightBlue
' Create TableCell objects to contain
' the text for the header.
Dim headerTableCell1 As New TableHeaderCell
Dim headerTableCell2 As New TableHeaderCell
Dim headerTableCell3 As New TableHeaderCell
headerTableCell1.Text = "Column 1 Header"
headerTableCell1.Scope = TableHeaderScope.Column
headerTableCell1.AbbreviatedText = "Col 1 Head"
headerTableCell2.Text = "Column 2 Header"
headerTableCell2.Scope = TableHeaderScope.Column
headerTableCell2.AbbreviatedText = "Col 2 Head"
headerTableCell3.Text = "Column 3 Header"
headerTableCell3.Scope = TableHeaderScope.Column
headerTableCell3.AbbreviatedText = "Col 3 Head"
' Add the TableHeaderCell objects to the Cells
' collection of the TableHeaderRow.
headerRow.Cells.Add(headerTableCell1)
headerRow.Cells.Add(headerTableCell2)
headerRow.Cells.Add(headerTableCell3)
' Add the TableHeaderRow as the first item
' in the Rows collection of the table.
Table1.Rows.AddAt(0, headerRow)
' Create a TableFooterRow.
Dim footerRow As New TableFooterRow
footerRow.BackColor = Color.LightBlue
' Create TableCell objects to contain the
' text for the footer.
Dim footerTableCell1 As New TableCell
Dim footerTableCell2 As New TableCell
Dim footerTableCell3 As New TableCell
footerTableCell1.Text = "Column 1 footer"
footerTableCell2.Text = "Column 2 footer"
footerTableCell3.Text = "Column 3 footer"
' Add the TableCell objects to the Cells
' collection of the TableFooterRow.
footerRow.Cells.Add(footerTableCell1)
footerRow.Cells.Add(footerTableCell2)
footerRow.Cells.Add(footerTableCell3)
' Add the TableFooterRow to the Rows
' collection of the table.
Table1.Rows.Add(footerRow)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>TableHeaderRow Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>TableHeaderRow and TableFooterRow Example</h3>
<asp:table id="Table1"
CellPadding="3"
CellSpacing="0"
Gridlines="Both"
runat="server">
</asp:table>
</div>
</form>
</body>
</html>
注解
类 TableHeaderRow 表示控件中的 Table 标题行。 此类支持在屏幕大小有限的设备上显示表。 在这些设备上，必须跨多个页面呈现包含多个列和行的表。 通过向Table控件添加 ，TableHeaderRow可以指定一个标题行，该行呈现为显示表视图的每个页面上的第一行。 有关屏幕大小受限的设备上呈现的表的视图格式的详细信息，请参阅 Table。
对象 TableHeaderRow 只能 TableCell 包含 对象。 若要将内容添加到 ， TableHeaderRow必须将一个或多个 TableCell 对象添加到行。 然后，设置 Text 行中每个 TableCell 对象的 属性，以指定每个单元格的内容。 或者，可以将控件添加到 TableCell 对象以指定其内容。
可以使用 集合以编程方式管理 中的TableHeaderRowCells单元格。 集合 Cells 是表示行中单元格的 TableCell 对象的集合。
从 TableHeaderRow 继承属性 TableRow ，使你可以控制行中内容的显示方式。 例如，可以使用 HorizontalAlign 和 VerticalAlign 属性来指定内容的对齐方式。
构造函数
| TableHeaderRow() |
初始化 TableHeaderRow 类的新实例。 |
属性
| AccessKey |
获取或设置使您得以快速导航到 Web 服务器控件的访问键。 (继承自 WebControl) |
| Adapter |
获取控件的浏览器特定适配器。 (继承自 Control) |
| AppRelativeTemplateSourceDirectory |
获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。 (继承自 Control) |
| Attributes |
获取与控件的特性不对应的任意特性（只用于呈现）的集合。 (继承自 WebControl) |
| BackColor |
获取或设置 Web 服务器控件的背景色。 (继承自 WebControl) |
| BindingContainer |
获取包含该控件的数据绑定的控件。 (继承自 Control) |
| BorderColor |
获取或设置 Web 控件的边框颜色。 (继承自 WebControl) |
| BorderStyle |
获取或设置 Web 服务器控件的边框样式。 (继承自 WebControl) |
| BorderWidth |
获取或设置 Web 服务器控件的边框宽度。 (继承自 WebControl) |
| Cells |
获取 TableCell 对象的集合，这些对象表示 Table 控件中的行的单元格。 (继承自 TableRow) |
| ChildControlsCreated |
获取一个值，该值指示是否已创建服务器控件的子控件。 (继承自 Control) |
| ClientID |
获取由 ASP.NET 生成的 HTML 标记的控件 ID。 (继承自 Control) |
| ClientIDMode |
获取或设置用于生成 ClientID 属性值的算法。 (继承自 Control) |
| ClientIDSeparator |
获取一个字符值，该值表示 ClientID 属性中使用的分隔符字符。 (继承自 Control) |
| Context |
为当前 Web 请求获取与服务器控件关联的 HttpContext 对象。 (继承自 Control) |
| Controls |
获取 ControlCollection 对象，该对象表示 UI 层次结构中的指定服务器控件的子控件。 (继承自 Control) |
| ControlStyle |
获取 Web 服务器控件的样式。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| ControlStyleCreated |
获取一个值，该值指示是否已为 Style 属性创建了 ControlStyle 对象。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| CssClass |
获取或设置由 Web 服务器控件在客户端呈现的级联样式表 (CSS) 类。 (继承自 WebControl) |
| DataItemContainer |
如果命名容器实现 IDataItemContainer，则获取对命名容器的引用。 (继承自 Control) |
| DataKeysContainer |
如果命名容器实现 IDataKeysControl，则获取对命名容器的引用。 (继承自 Control) |
| DesignMode |
获取一个值，该值指示是否正在使用设计图面上的一个控件。 (继承自 Control) |
| Enabled |
获取或设置一个值，该值指示是否启用 Web 服务器控件。 (继承自 WebControl) |
| EnableTheming |
获取或设置一个值，该值指示主题是否应用于该控件。 (继承自 WebControl) |
| EnableViewState |
获取或设置一个值，该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。 (继承自 Control) |
| Events |
获取控件的事件处理程序委托列表。 此属性为只读。 (继承自 Control) |
| Font |
获取与 Web 服务器控件关联的字体属性。 (继承自 WebControl) |
| ForeColor |
获取或设置 Web 服务器控件的前景色（通常是文本颜色）。 (继承自 WebControl) |
| HasAttributes |
获取一个值，该值指示控件是否具有特性集。 (继承自 WebControl) |
| HasChildViewState |
获取一个值，该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。 (继承自 Control) |
| Height |
获取或设置 Web 服务器控件的高度。 (继承自 WebControl) |
| HorizontalAlign |
获取或设置行内容的水平对齐方式。 (继承自 TableRow) |
| ID |
获取或设置分配给服务器控件的编程标识符。 (继承自 Control) |
| IdSeparator |
获取用于分隔控件标识符的字符。 (继承自 Control) |
| IsChildControlStateCleared |
获取一个值，该值指示该控件中包含的控件是否具有控件状态。 (继承自 Control) |
| IsEnabled |
获取一个值，该值指示是否启用控件。 (继承自 WebControl) |
| IsTrackingViewState |
获取一个值，用于指示服务器控件是否会将更改保存到其视图状态中。 (继承自 Control) |
| IsViewStateEnabled |
获取一个值，该值指示是否为该控件启用了视图状态。 (继承自 Control) |
| LoadViewStateByID |
获取一个值，该值指示控件是否通过 ID 而不是索引参与加载其视图状态。 (继承自 Control) |
| NamingContainer |
获取对服务器控件的命名容器的引用，此引用创建唯一的命名空间，以区分具有相同 ID 属性值的服务器控件。 (继承自 Control) |
| Page |
获取对包含服务器控件的 Page 实例的引用。 (继承自 Control) |
| Parent |
获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 Control) |
| RenderingCompatibility |
获取一个值，该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。 (继承自 Control) |
| Site |
获取容器信息，该容器在呈现于设计图面上时承载当前控件。 (继承自 Control) |
| SkinID |
获取或设置要应用于控件的外观。 (继承自 WebControl) |
| Style |
获取将在 Web 服务器控件的外部标记上呈现为样式特性的文本特性的集合。 (继承自 WebControl) |
| SupportsDisabledAttribute |
获取一个值，该值指示在控件的 |
| TabIndex |
获取或设置 Web 服务器控件的选项卡索引。 (继承自 WebControl) |
| TableSection |
获取或设置 TableRow 控件中 Table 对象的位置。 (继承自 TableRow) |
| TagKey |
获取对应于此 Web 服务器控件的 HtmlTextWriterTag 值。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| TagName |
获取控件标记的名称。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| TemplateControl |
获取或设置对包含该控件的模板的引用。 (继承自 Control) |
| TemplateSourceDirectory |
获取包含当前服务器控件的 Page 或 UserControl 的虚拟目录。 (继承自 Control) |
| ToolTip |
获取或设置当鼠标指针悬停在 Web 服务器控件上时显示的文本。 (继承自 WebControl) |
| UniqueID |
获取服务器控件的唯一的、以分层形式限定的标识符。 (继承自 Control) |
| ValidateRequestMode |
获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。 (继承自 Control) |
| VerticalAlign |
获取或设置行内容的垂直对齐方式。 (继承自 TableRow) |
| ViewState |
获取状态信息的字典，这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。 (继承自 Control) |
| ViewStateIgnoresCase |
获取一个值，该值指示 StateBag 对象是否不区分大小写。 (继承自 Control) |
| ViewStateMode |
获取或设置此控件的视图状态模式。 (继承自 Control) |
| Visible |
获取或设置一个值，该值指示服务器控件是否作为 UI 呈现在页上。 (继承自 Control) |
| Width |
获取或设置 Web 服务器控件的宽度。 (继承自 WebControl) |
方法
事件
| DataBinding |
当服务器控件绑定到数据源时发生。 (继承自 Control) |
| Disposed |
当从内存释放服务器控件时发生，这是请求 ASP.NET 页时服务器控件生存期的最后阶段。 (继承自 Control) |
| Init |
当服务器控件初始化时发生；初始化是控件生存期的第一步。 (继承自 Control) |
| Load |
当服务器控件加载到 Page 对象中时发生。 (继承自 Control) |
| PreRender |
在加载 Control 对象之后、呈现之前发生。 (继承自 Control) |
| Unload |
当服务器控件从内存中卸载时发生。 (继承自 Control) |
显式接口实现
扩展方法
| FindDataSourceControl(Control) |
返回与指定控件的数据控件关联的数据源。 |
| FindFieldTemplate(Control, String) |
返回指定控件的命名容器中指定列的字段模板。 |
| FindMetaTable(Control) |
返回包含数据控件的元表对象。 |
