Wednesday, November 22, 2006

Building a GridView, DataGrid or Table with THEAD, TBODY or TFOOT sections

There are 726 articles on Google when you search "gridview thead". Most of them, and certainly all the first ones, talk about not being able to render thead, tbody and tfoot elements for NET 2.0 table based controls. But it's not so!

Each table row has a property called TableSection. If you set it to TableRowSection.TableHeader, TableBody or TableFooter, the specific tags will be created. Let me show a quick example of creating a THEAD element in a gridview:

And that's it. This kind of behaviour works for the Table WebControl and everything that derives from it or uses it to render itself.
However, the rendering of these elements inside the Table control is done simply with writer.RenderBeginTag(HtmlTextWriterTag.Thead), which gives no one the ability to change from .NET code the attributes of those sections. You can't have it all! You can use CSS, though. ex:
.tableClass thead {


A.A said...

Tank you much!
You saved me alot of time

wechel said...

Make sure you set this after data has been bound.

void grid_DataBound(object sender, EventArgs e)
grid.HeaderRow.TableSection = TableRowSection.TableHeader;

Siderite said...

well, yes, best option is at prerender, I think.

Anonymous said...

Thank you. This was exactly what I was looking for!

Anonymous said...

Siderite, thanks for the good work - it was very helpful. however, i'm having issues setting the TableSection for the Rows (to generate TBODY. Can you please post the syntax for that?

Siderite said...

foreach (GridViewRow row in grid.Rows) row.TableSection=TableRowSection.TableBody;

Anonymous said...

Brilliant. Thank you very much!

Anonymous said...

Solution is described at my blog at

Anonymous said...

Hey that code doesn't work for datagrid.

Gatagrid.UseAccessibleHeader = True
renders th tags for header columns
unfortunetly not thead tag

Siderite said...

Who uses a DataGrid anymore? Isn't that .Net 1.1? The post does say NET2.0 table based controls.