Skip to main content
.NET Framework Class Library
ControlOnPreRender Method

Raises the PreRender event.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)
Syntax
Protected Friend Overridable Sub OnPreRender ( _
	e As [%$TOPIC/00ea18ad_en-us_VS_110_2_0_0_0_0%] _
)
protected internal virtual void OnPreRender(
	[%$TOPIC/00ea18ad_en-us_VS_110_2_0_1_0_0%] e
)
protected public:
virtual void OnPreRender(
	[%$TOPIC/00ea18ad_en-us_VS_110_2_0_2_0_0%]^ e
)
abstract OnPreRender : 
        e:[%$TOPIC/00ea18ad_en-us_VS_110_2_0_3_0_0%] -> unit  
override OnPreRender : 
        e:[%$TOPIC/00ea18ad_en-us_VS_110_2_0_3_0_1%] -> unit

Parameters

e
Type: SystemEventArgs

An EventArgs object that contains the event data.

Remarks

ASP.NET calls this method to raise the PreRender event. If you are developing a custom control, you can override this method in order to provide additional processing. If you override this method, call the base control's OnPreRender method to notify subscribers to the event.

Examples
' Override the OnPreRender method to set _message to 
' a default value if it is null. 
Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
    MyBase.OnPreRender(e)
    If _message Is Nothing Then
        _message = "Here is some default text." 
    End If 
End Sub
// Override the OnPreRender method to set _message to 
// a default value if it is null. 
protected override void OnPreRender(EventArgs e)
{
    base.OnPreRender(e);
    if (_message == null)
        _message = "Here is some default text.";
}
Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.