.NET Framework Class Library
Control..::.OnPreRender Method

Updated: November 2007

Raises the PreRender event.

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

Visual Basic (Declaration)
Protected Friend Overridable Sub OnPreRender ( _
    e As EventArgs _
)
Visual Basic (Usage)
Dim e As EventArgs

Me.OnPreRender(e)
C#
protected internal virtual void OnPreRender(
    EventArgs e
)
Visual C++
protected public:
virtual void OnPreRender(
    EventArgs^ e
)
J#
protected void OnPreRender(
    EventArgs e
)
JScript
protected internal function OnPreRender(
    e : EventArgs
)

Parameters

e
Type: System..::.EventArgs

An EventArgs object that contains the event data.

This method notifies the server control to perform any necessary pre-rendering steps prior to saving view state and rendering content.

The following example overrides the OnPreRender method in a custom server control. When the custom control is requested from an ASP.NET page, during the PreRender stage of page processing, OnPreRender method is called and the custom PreRender_Handler method sends its _message property value, "Parent Text was changed by PreRender method", to the page.

Visual Basic
Protected Overrides Sub OnPreRender(e As EventArgs)
   MyBase.OnPreRender(e)
End Sub

Private Sub PreRender_Handler(sender As Object, e As System.EventArgs)
   _message = "Parent Text was changed by PreRender method"
End Sub


C#
protected override void OnPreRender(EventArgs e)
{
   base.OnPreRender(e);
}      

private void PreRender_Handler(object sender,System.EventArgs e)
{
   _message = "Parent Text was changed by PreRender method";
}


J#
protected void OnPreRender(EventArgs e)
{
    super.OnPreRender(e);
} //OnPreRender

private void PreRender_Handler(Object sender, System.EventArgs e)
{
    _message = "Parent Text was changed by PreRender method";
} //PreRender_Handler

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, 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, 1.1, 1.0
Page view tracker