This topic has not yet been rated - Rate this topic

Table.RenderContents Method

.NET Framework 4

Other Versions

Renders the rows in the table control to the specified writer.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)

Syntax

C++

Copy

protected internal override void RenderContents(
	HtmlTextWriter writer
)

Parameters

writer: Type: System.Web.UI.HtmlTextWriter
An HtmlTextWriter that represents the output stream to render HTML content on the client.

Exceptions

Exception	Condition
HttpException	The table sections are not in order.

Remarks

This method is used primarily by control developers when deriving a custom class from a Table control.

The Table control implements the RenderContents to render the Rows of the table.

Examples

The following code example demonstrates how to override the RenderContents method in a custom server control so that it always inserts a header row for a custom Table server control.

Copy


<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
        <title>Custom Table - RenderContents - C# Example</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom Table - RenderContents - C# Example</h3>

            <aspSample:CustomTableRenderContents 
              id="Table1" 
              runat="server" 
              GridLines="Both">
        <asp:TableRow>
          <asp:TableCell>Row 0, Col 0</asp:TableCell>
          <asp:TableCell>Row 0, Col 1</asp:TableCell>
        </asp:TableRow>
        <asp:TableRow>
          <asp:TableCell>Row 1, Col 0</asp:TableCell>
          <asp:TableCell>Row 1, Col 1</asp:TableCell>
        </asp:TableRow>
      </aspSample:CustomTableRenderContents>

        </form>
    </body>
</html>


...


using System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomTableRenderContents : System.Web.UI.WebControls.Table
  {
    protected override void RenderContents(System.Web.UI.HtmlTextWriter writer)
    {
      // Insert a header row.
      writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Tr);
      writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Th);
      writer.Write("Col 0");
      writer.RenderEndTag();
      writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Th);
      writer.Write("Col 1");
      writer.RenderEndTag();
      writer.RenderEndTag();

      // Call the base RenderContents method.
      base.RenderContents(writer);
    }
  }
}

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Table Class

System.Web.UI.WebControls Namespace

Other Resources

Table, TableRow, and TableCell Web Server Control Overview

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ