TableHeaderCell.Scope Property
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.
Gets or sets the scope of the TableHeaderCell control when it is rendered.
public:
virtual property System::Web::UI::WebControls::TableHeaderScope Scope { System::Web::UI::WebControls::TableHeaderScope get(); void set(System::Web::UI::WebControls::TableHeaderScope value); };public virtual System.Web.UI.WebControls.TableHeaderScope Scope { get; set; }member this.Scope : System.Web.UI.WebControls.TableHeaderScope with get, setPublic Overridable Property Scope As TableHeaderScopeProperty Value
A TableHeaderScope value. The default is NotSet.
Examples
The following code example demonstrates how to program the Scope property declaratively. Note the use of the AssociatedHeaderCellID property.
<%@ page language="C#" %>
<!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>TableHeaderCell Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h1>TableHeaderCell Example</h1>
<asp:table id="Table1" runat="server"
CellPadding="3"
CellSpacing="3"
BorderWidth="1"
GridLines="Both">
<asp:TableHeaderRow ID="TableHeaderRow1" runat="server">
<asp:TableHeaderCell runat="server"
ID="Column1Header"
CategoryText="Column1"
AbbreviatedText="Header 1"
Scope="Column"
HorizontalAlign="Center"
VerticalAlign="Middle"
BackColor="LightGray">
Column 1 Header
</asp:TableHeaderCell>
<asp:TableHeaderCell runat="server"
ID="Column2Header"
CategoryText="Column2,Column2Alternative"
AbbreviatedText="Header 2"
Scope="Column"
HorizontalAlign="Center"
VerticalAlign="Middle"
BackColor="LightGray">
Column 2 Header
</asp:TableHeaderCell>
<asp:TableHeaderCell runat="server"
ID="Column3Header"
CategoryText="Column3"
AbbreviatedText="Header 3"
Scope="Column"
HorizontalAlign="Center"
VerticalAlign="Middle"
BackColor="LightGray">
Column 3 Header
</asp:TableHeaderCell>
</asp:TableHeaderRow>
<asp:TableRow HorizontalAlign="Center">
<asp:TableCell AssociatedHeaderCellID="Column1Header"
HorizontalAlign="Left">
(0,0)
</asp:TableCell>
<asp:TableCell
AssociatedHeaderCellID="Column2Header">
(0,1)
</asp:TableCell>
<asp:TableCell
AssociatedHeaderCellID="Column3Header">
(0,2)
</asp:TableCell>
</asp:TableRow>
<asp:TableRow
HorizontalAlign="Center">
<asp:TableCell
AssociatedHeaderCellID="Column1Header"
HorizontalAlign="Left">
(1,0)
</asp:TableCell>
<asp:TableCell
AssociatedHeaderCellID="Column2Header">
(1,1)
</asp:TableCell>
<asp:TableCell
AssociatedHeaderCellID="Column3Header">
(1,2)
</asp:TableCell>
</asp:TableRow>
<asp:TableRow
HorizontalAlign="Center">
<asp:TableCell
AssociatedHeaderCellID=
"Column1Header,Column2Header,Column3Header"
ColumnSpan="3"
HorizontalAlign="Left">
(2,0)
</asp:TableCell>
</asp:TableRow>
</asp:table>
</div>
</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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>TableHeaderCell Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h1>TableHeaderCell Example</h1>
<asp:table id="Table1" runat="server"
CellPadding="3"
CellSpacing="3"
BorderWidth="1"
GridLines="Both">
<asp:TableHeaderRow ID="TableHeaderRow1" runat="server">
<asp:TableHeaderCell runat="server"
ID="Column1Header"
CategoryText="Column1"
AbbreviatedText="Header 1"
Scope="Column"
HorizontalAlign="Center"
VerticalAlign="Middle"
BackColor="LightGray">
Column 1 Header
</asp:TableHeaderCell>
<asp:TableHeaderCell runat="server"
ID="Column2Header"
CategoryText="Column2,Column2Alternative"
AbbreviatedText="Header 2"
Scope="Column"
HorizontalAlign="Center"
VerticalAlign="Middle"
BackColor="LightGray">
Column 2 Header
</asp:TableHeaderCell>
<asp:TableHeaderCell runat="server"
ID="Column3Header"
CategoryText="Column3"
AbbreviatedText="Header 3"
Scope="Column"
HorizontalAlign="Center"
VerticalAlign="Middle"
BackColor="LightGray">
Column 3 Header
</asp:TableHeaderCell>
</asp:TableHeaderRow>
<asp:TableRow HorizontalAlign="Center">
<asp:TableCell AssociatedHeaderCellID="Column1Header"
HorizontalAlign="Left">
(0,0)
</asp:TableCell>
<asp:TableCell
AssociatedHeaderCellID="Column2Header">
(0,1)
</asp:TableCell>
<asp:TableCell
AssociatedHeaderCellID="Column3Header">
(0,2)
</asp:TableCell>
</asp:TableRow>
<asp:TableRow
HorizontalAlign="Center">
<asp:TableCell
AssociatedHeaderCellID="Column1Header"
HorizontalAlign="Left">
(1,0)
</asp:TableCell>
<asp:TableCell
AssociatedHeaderCellID="Column2Header">
(1,1)
</asp:TableCell>
<asp:TableCell
AssociatedHeaderCellID="Column3Header">
(1,2)
</asp:TableCell>
</asp:TableRow>
<asp:TableRow
HorizontalAlign="Center">
<asp:TableCell
AssociatedHeaderCellID=
"Column1Header,Column2Header,Column3Header"
ColumnSpan="3"
HorizontalAlign="Left">
(2,0)
</asp:TableCell>
</asp:TableRow>
</asp:table>
</div>
</form>
</body>
</html>
Remarks
Use the Scope property to get or set the scope of the TableHeaderCell control when it is rendered. The scope of the TableHeaderCell represents the cells that the header applies to. For complex tables, use the AssociatedHeaderCellID property, which provides more control over the specification of the relationship of header cells to data cells. The Scope property is used to make HTML tables more accessible by providing information about relationships between the cells and the headers.
For a list of the available table header scopes, see TableHeaderScope.
The value of this property is stored in view state.
Applies to
See also
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
