HideDisabledControlAdapter::Render Method
Writes the associated Web control to the output stream as HTML.
Assembly: System.Web (in System.Web.dll)
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.
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.