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
)

Parameters

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.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

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.
Show: