This documentation is archived and is not being maintained.

HideDisabledControlAdapter::Render Method

Writes the associated Web control to the output stream as HTML.

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

protected public:
virtual void Render(
	HtmlTextWriter^ writer
) override

Parameters

writer
Type: System.Web.UI::HtmlTextWriter

The HtmlTextWriter containing methods to build and render the device-specific output.

The Render method writes the associated WebControl control to the output stream as HTML.

By default, the .NET Framework calls on the Web server control's own Render method. However, once the Adapter property of that control is set, the .NET Framework will execute the adapter's implementation of the Render event over that of the associated control.

The Render event is used to perform modifications to the markup code that is rendered to a device browser. Control properties should be set prior to this phase of the life cycle and only the actual markup creation for the control done here. Changes made to the control in this stage of the life cycle are not saved to view state. For saving changes made to the control, override the OnPreRender event.

The Render event also allows derived classes to handle the event without attaching a delegate, which is the preferred technique for handling the event in a derived class.

The following code example demonstrates how to override the Render method to pass the HtmlTextWriter object to the parent control for rendering if the associated control is enabled. This code example is part of a larger example provided for the HideDisabledControlAdapter class.

No code example is currently available or this language may not be supported.

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