This documentation is archived and is not being maintained.

Control.RenderControl Method (HtmlTextWriter, ControlAdapter)

Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

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

protected void RenderControl(
	HtmlTextWriter writer,
	ControlAdapter adapter


Type: System.Web.UI.HtmlTextWriter

The HtmlTextWriter that receives the control content.

Type: System.Web.UI.Adapters.ControlAdapter

The ControlAdapter that defines the rendering.

ASP.NET Web pages are usable across a wide range of devices and browsers that can request information from the Web. The Adapter property returns the ControlAdapter object that renders the control on the requesting device or browser's screen.

For more information about adapters, see Architectural Overview of Adaptive Control Behavior.

If a server control's Visible property is set to true and tracing is enabled for the page, then trace information associated with the control is captured.

Notes to Inheritors:

When overriding the RenderControl method in custom controls, call the base class method to ensure trace information is correctly captured.

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