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
protected void Render (
	HtmlTextWriter writer
)
protected internal override function Render (
	writer : HtmlTextWriter
)
Not applicable.

Parameters

writer

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 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show: