XafApplication.DelayedViewItemsInitialization Property

Indicates whether View Items controls are initialized immediately when a View is created.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

[Browsable(false)]
[DefaultValue(true)]
public bool DelayedViewItemsInitialization { get; set; }

VB.NET

<Browsable(False)>
<DefaultValue(True)>
Public Property DelayedViewItemsInitialization As Boolean

Property Value

Type	Default	Description
Boolean	true	true, if View Item controls are initialized once they are visible to end-users; false, if View Item controls are initialized once a View is created. The default value is true.

Remarks

When this property is set to true, controls corresponding to View Items will not be created immediately after the root control of the View is created. Instead, they will be created only once they are visible to end-users. Complex Property Editors will also create their Frame and View only when their respective controls are created. Since their Frame, View and Control properties are null before the editors are visible, that leads to a potential problem in your code. So, instead of handling the View.ControlsCreated and ViewController.ViewControlsCreated events to access a View Item’s control, you should ensure that you are not accessing the properties mentioned above before the controls are created. In order to bypass any possible problems, you should handle the ViewItem.ControlCreated event of the required View Item or test whether the properties accessed are null.

You can change the default value of the DelayedViewItemsInitialization property in the XafApplication descendant’s constructor implemented in the default WinForms, ASP.NET Web Forms, and ASP.NET Core Blazor application project. For instance, here is the code for the Windows Forms application.

C#

public partial class MySolutionWindowsFormsApplication : WinApplication {
    public MySolutionWindowsFormsApplication() {
        InitializeComponent();
        DelayedViewItemsInitialization = false;
    }
    // ...
}

VB.NET

Partial Public Class MySolutionWindowsFormsApplication
    Inherits WinApplication
    Public Sub New()
        InitializeComponent()
        DelayedViewItemsInitialization = False
    End Sub
    ' ...
End Class

To change this behavior for an individual View, use the CompositeView.DelayedItemsInitialization property.