WebApplication.PreferredApplicationWindowTemplateType Property

Specifies the Template type for the application’s main page.

Namespace: DevExpress.ExpressApp.Web

Assembly: DevExpress.ExpressApp.Web.v24.1.dll

NuGet Package: DevExpress.ExpressApp.Web

Declaration

C#

public static TemplateType PreferredApplicationWindowTemplateType { get; set; }

VB.NET

Public Shared Property PreferredApplicationWindowTemplateType As TemplateType

Property Value

Type	Description
TemplateType	A TemplateType enumeration value that specifies the Template type for the application’s main page. The default is TemplateType.Vertical.

Available values:

Name	Description
Horizontal	A main window with horizontal navigation template.
Vertical	A main window with vertical navigation template.
Logon	A logon window template.
Dialog	A dialog window template.
FindDialog	A search dialog window template.
NestedFrameControl	A nested frame control template.

Remarks

To use the Default Template for the main window instead of DefaultVertical, set the PreferredApplicationWindowTemplateType property to TemplateType.Horizontal in the ASP.NET Web Forms application’s Session_Start event handler (you can find this handler code in the Global.asax.cs (Global.asax.vb) file).

C#

using DevExpress.ExpressApp.Web.Templates;
// ... 
protected void Session_Start(Object sender, EventArgs e) {
    WebApplication.SetInstance(Session, new MySolutionAspNetApplication());
    // ... 
    WebApplication.PreferredApplicationWindowTemplateType = TemplateType.Horizontal;
}

VB.NET

Imports DevExpress.ExpressApp.Web.Templates
' ...
Protected Sub Session_Start(ByVal sender As Object, ByVal e As EventArgs)
    WebApplication.SetInstance(Session, New MySolutionAspNetApplication())
    ' ...
    WebApplication.PreferredApplicationWindowTemplateType = TemplateType.Horizontal
End Sub

Note

The PreferredApplicationWindowTemplateType property should be initialized after the WebApplication.SetInstance method is called. Otherwise, the “Cannot change the ValueManager.ValueManagerType property after it’s initialized“ error may occur.