Control.RenderControl Method (HtmlTextWriter, ControlAdapter) (System.Web.UI)

RenderControl Method (HtmlTextWriter, ControlAd...

.NET Framework Class Library

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)

Syntax

Visual Basic (Declaration)

Protected Sub RenderControl ( _
    writer As HtmlTextWriter, _
    adapter As ControlAdapter _
)

Visual Basic (Usage)

Dim writer As HtmlTextWriter
Dim adapter As ControlAdapter

Me.RenderControl(writer, adapter)

protected void RenderControl(
    HtmlTextWriter writer,
    ControlAdapter adapter
)

Visual C++

protected:
void RenderControl(
    HtmlTextWriter^ writer, 
    ControlAdapter^ adapter
)

JScript

protected function RenderControl(
    writer : HtmlTextWriter, 
    adapter : ControlAdapter
)

Parameters

writer: Type: System.Web.UI..::.HtmlTextWriter
The HtmlTextWriter that receives the control content.

adapter: Type: System.Web.UI.Adapters..::.ControlAdapter
The ControlAdapter that defines the rendering.

Remarks

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.

Platforms

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.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

Control Class

Control Members

RenderControl Overload

System.Web.UI Namespace

Adapter

ControlAdapter

Trace

Other Resources

Architectural Overview of Adaptive Control Behavior