Control.OnPreRender Method (System.Web.UI)

Switch View :

ScriptFree

.NET Framework Class Library

Control.OnPreRender Method

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Raises the PreRender event.

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

Syntax

Visual Basic

Protected Friend Overridable Sub OnPreRender ( _
	e As EventArgs _
)

protected internal virtual void OnPreRender(
	EventArgs e
)

Visual C++

protected public:
virtual void OnPreRender(
	EventArgs^ e
)

abstract OnPreRender : 
        e:EventArgs -> unit 
override OnPreRender : 
        e:EventArgs -> unit

Parameters

e: Type: System.EventArgs
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

Visual Basic


' 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 Consumer Preview, Windows Server 8 Beta, Windows 7, Windows Server 2008 SP2, 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.

Reference

Control Class

System.Web.UI Namespace

Page

Other Resources

ASP.NET Page Life Cycle Overview