HideDisabledControlAdapter::Render Method (HtmlTextWriter^)
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.
Available since 2.0