This documentation is archived and is not being maintained.

WebControlAdapter.RenderContents Method

Generates the target-specific inner markup for the Web control to which the control adapter is attached.

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

protected virtual void RenderContents(
	HtmlTextWriter writer


Type: System.Web.UI.HtmlTextWriter

The HtmlTextWriter containing methods to render the target-specific output.

The RenderContents method generates the inner markup, between the beginning and ending tags for the control. Typically, markup is generated by Render, which calls methods in the following order:

  1. RenderBeginTag.

  2. RenderContents.

  3. RenderEndTag.

Override RenderContents to generate target-specific inner markup to send to the client browser.

The RenderContents base method calls WebControl.RenderContents. The WebControl.RenderContents base method calls Control.Render, which in turn calls Control.RenderChildren. Thus, overrides of RenderContents should call the RenderContents base method only if its processing is in addition to, rather than instead of, Control.Render.

Notes to Inheritors:

For a composite control, you must ensure that the child controls are rendered. If you override the RenderContents method and do not call its base method, you can cause the child controls to be rendered by calling RenderChildren which, if not overridden, calls Control.RenderChildren from the RenderContents override.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0