WebWindow.PagePreRender Event

Occurs after the WebWindow‘s Web Forms page is loaded, but prior to rendering.

Namespace: DevExpress.ExpressApp.Web

Assembly: DevExpress.ExpressApp.Web.v23.2.dll

NuGet Package: DevExpress.ExpressApp.Web

Declaration

C#

public event EventHandler PagePreRender

VB.NET

Public Event PagePreRender As EventHandler

Event Data

The PagePreRender event's data class is EventArgs.

Remarks

Handle this event to perform any updates before the Window’s page is rendered. The page can be accessed via the Window.Template property.

C#

using System.Web.UI;
using DevExpress.ExpressApp.Web;
//...
public class MyController : WindowController {
    protected override void OnActivated() {
        base.OnActivated();
        ((WebWindow)Window).PagePreRender += PagePreRender;
    }
    protected override void OnDeactivated() {
        ((WebWindow)Window).PagePreRender -= PagePreRender;
        base.OnDeactivated();
    }
    private void PagePreRender(object sender, EventArgs e) {
        // Access the page via the Template property:           
        ControlCollection pageControls = (((WebWindow)sender).Template as Page).Controls;
        // ...
    }
}

VB.NET

Imports System.Web.UI
Imports DevExpress.ExpressApp.Web
'...
Public Class MyController
    Inherits WindowController
    Protected Overrides Sub OnActivated()
        MyBase.OnActivated()
        AddHandler (CType(Window, WebWindow)).PagePreRender, AddressOf PagePreRender
    End Sub
    Protected Overrides Sub OnDeactivated()
        RemoveHandler (CType(Window, WebWindow)).PagePreRender, AddressOf PagePreRender
        MyBase.OnDeactivated()
    End Sub
    Private Sub PagePreRender(ByVal sender As Object, ByVal e As EventArgs)
        ' Access the page via the Template property:           
        Dim pageControls As ControlCollection = _
        (TryCast((CType(sender, WebWindow)).Template, Page)).Controls
        ' ...
    End Sub
End Class

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the PagePreRender event.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

xaf-how-to-create-information-panels/CS/InfoPanels.Web/MyDefaultVerticalTemplateContent.ascx.cs#L18

if (WebWindow.CurrentRequestWindow != null) {
    WebWindow.CurrentRequestWindow.PagePreRender += new EventHandler(CurrentRequestWindow_PagePreRender);
}

xaf-how-to-customize-an-aspnet-template/CS/CustomWebTemplate/CustomWebTemplate.Web/MyDefaultVerticalTemplateContent.ascx.cs#L30

if (WebWindow.CurrentRequestWindow != null) {
    WebWindow.CurrentRequestWindow.PagePreRender += new EventHandler(CurrentRequestWindow_PagePreRender);
}

xaf-how-to-implement-dependent-views-in-a-dashboardview-filter-based-on-selection/CS/Solution3.Module.Web/Controllers/DashboardRefreshController.cs#L16

if(WebWindow.CurrentRequestWindow == null) return;
WebWindow.CurrentRequestWindow.PagePreRender -= CurrentRequestWindow_PagePreRender;
WebWindow.CurrentRequestWindow.PagePreRender += CurrentRequestWindow_PagePreRender;

VB.NET

xaf-how-to-create-information-panels/VB/InfoPanels.Web/MyDefaultVerticalTemplateContent.ascx.vb#L20

If WebWindow.CurrentRequestWindow IsNot Nothing Then
    AddHandler WebWindow.CurrentRequestWindow.PagePreRender, AddressOf CurrentRequestWindow_PagePreRender
End If

xaf-how-to-implement-dependent-views-in-a-dashboardview-filter-based-on-selection/VB/Solution3.Module.Web/Controllers/DashboardRefreshController.vb#L20

End If
RemoveHandler WebWindow.CurrentRequestWindow.PagePreRender, AddressOf CurrentRequestWindow_PagePreRender
AddHandler WebWindow.CurrentRequestWindow.PagePreRender, AddressOf CurrentRequestWindow_PagePreRender