DataGrid.ShowHeader Property
.NET Framework 2.0
Gets or sets a value that indicates whether the header is displayed in the DataGrid control.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Assembly: System.Web (in system.web.dll)
Set this property to true to display the header in the DataGrid. The appearance of the header is controlled by using the HeaderStyle property.
The following code example demonstrates how to use the ShowHeader property to hide the header on the DataGrid control.
<%@ Page Language="C#" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script language="C#" runat="server"> ICollection CreateDataSource() { DataTable dt = new DataTable(); DataRow dr; dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32))); dt.Columns.Add(new DataColumn("StringValue", typeof(string))); dt.Columns.Add(new DataColumn("DateTimeValue", typeof(string))); dt.Columns.Add(new DataColumn("BoolValue", typeof(bool))); for (int i = 0; i < 100; i++) { dr = dt.NewRow(); dr[0] = i; dr[1] = "Item " + i.ToString(); dr[2] = DateTime.Now.ToShortDateString(); dr[3] = (i % 2 != 0) ? true : false; dt.Rows.Add(dr); } DataView dv = new DataView(dt); return dv; } void Page_Load(Object sender, EventArgs E ) { if (chk1.Checked) MyDataGrid.PagerStyle.Mode = PagerMode.NumericPages; else MyDataGrid.PagerStyle.Mode = PagerMode.NextPrev; BindGrid(); } void MyDataGrid_Page(Object sender, DataGridPageChangedEventArgs e) { BindGrid(); } void BindGrid() { MyDataGrid.DataSource = CreateDataSource(); MyDataGrid.DataBind(); ShowStats(); } void ShowStats() { lblEnabled.Text = "AllowPaging is " + MyDataGrid.AllowPaging; lblCurrentIndex.Text = "CurrentPageIndex is " + MyDataGrid.CurrentPageIndex; lblPageCount.Text = "PageCount is " + MyDataGrid.PageCount; lblPageSize.Text = "PageSize is " + MyDataGrid.PageSize; } </script> <body> <h3>DataGrid Example</h3> <form runat=server> <asp:DataGrid id="MyDataGrid" runat="server" AllowPaging="True" PageSize="10" ShowFooter="true" ShowHeader="false" OnPageIndexChanged="MyDataGrid_Page" BorderColor="black" BorderWidth="1" GridLines="Both" CellPadding="3" CellSpacing="0" Font-Name="Verdana" Font-Size="8pt"> <HeaderStyle BackColor="#aaaadd"> </HeaderStyle> <FooterStyle BackColor="#aaaadd"> </FooterStyle> <AlternatingItemStyle BackColor="#eeeeee"> </AlternatingItemStyle> <PagerStyle Mode="NumericPages" HorizontalAlign="Right"> </PagerStyle> </asp:DataGrid> <p> <asp:Checkbox id="chk1" runat="server" Text="Show numeric page navigation buttons" Font-Name="Verdana" Font-Size="8pt" AutoPostBack="true"/> <p> <table bgcolor="#eeeeee" cellpadding="6"> <tr> <td nowrap> <asp:Label id="lblEnabled" runat="server"/><br> <asp:Label id="lblCurrentIndex" runat="server"/><br> <asp:Label id="lblPageCount" runat="server"/><br> <asp:Label id="lblPageSize" runat="server"/><br> </td> </tr> </table> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <html> <script runat="server"> ICollection CreateDataSource() { // Create a Random object to mix up the order of items in the // sample data. Random Rand_Num = new Random(); // Create sample data for the DataGrid control. DataTable dt = new DataTable(); DataRow dr; // Define the columns of the table. dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32))); dt.Columns.Add(new DataColumn("StringValue", typeof(String))); dt.Columns.Add(new DataColumn("CurrencyValue", typeof(Double))); // Populate the table with sample values. for (int i=0; i<=8; i++) { dr = dt.NewRow(); dr[0] = i; dr[1] = "Item " + Rand_Num.Next(1, 15).ToString(); dr[2] = 1.23 * Rand_Num.Next(1, 15); dt.Rows.Add(dr); } DataView dv = new DataView(dt); return dv; } void Page_Load(Object sender, EventArgs e) { // Load sample data only once, when the page is first loaded. if (!IsPostBack) { ItemsGrid.DataSource = CreateDataSource(); ItemsGrid.DataBind(); } } void Check_Change(Object sender, EventArgs e) { // Show or hide the header depending on the user's selection. if (ShowHeaderCheckBox.Checked) { ItemsGrid.ShowHeader = true; } else { ItemsGrid.ShowHeader = false; } // Show or hide the footer depending on the user's selection. if (ShowFooterCheckBox.Checked) { ItemsGrid.ShowFooter = true; } else { ItemsGrid.ShowFooter = false; } } </script> <body> <form runat=server> <h3>DataGrid ShowHeader and ShowFooter Example</h3> Select whether to show or hide the header and footer sections in the DataGrid control. <br><br> <b>Product List</b> <asp:DataGrid id="ItemsGrid" BorderColor="black" BorderWidth="1" CellPadding="3" ShowHeader="True" ShowFooter="True" AutoGenerateColumns="False" runat="server"> <HeaderStyle BackColor="#00aaaa"> </HeaderStyle> <FooterStyle BackColor="#00aaaa"> </FooterStyle> <Columns> <asp:BoundColumn DataField="IntegerValue" SortExpression="IntegerValue" HeaderText="Item"/> <asp:BoundColumn DataField="StringValue" SortExpression="StringValue" HeaderText="Description"/> <asp:BoundColumn DataField="CurrencyValue" HeaderText="Price" SortExpression="CurrencyValue" DataFormatString="{0:c}"> <ItemStyle HorizontalAlign="Right"> </ItemStyle> </asp:BoundColumn> </Columns> </asp:DataGrid> <hr> <asp:CheckBox id="ShowHeaderCheckBox" Text="Show header" AutoPostBack="True" Checked="True" OnCheckedChanged="Check_Change" runat="server"/>   <asp:CheckBox id="ShowFooterCheckBox" Text="Show footer" AutoPostBack="True" Checked="True" OnCheckedChanged="Check_Change" runat="server"/> </form> </body> </html>
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
