Control.RenderControl Method (HtmlTextWriter, ControlAdapter)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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.

.NET Framework
Available since 2.0
Return to top