Skip to main content
.NET Framework 4.6.2+
  • The page you are viewing does not exist in the .NET 8.0+ platform documentation. This link will take you to the parent topic of the current section.

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

WebApplication.PreferredApplicationWindowTemplateType Property

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

Namespace: DevExpress.ExpressApp.Web

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

NuGet Package: DevExpress.ExpressApp.Web

#Declaration

public static TemplateType PreferredApplicationWindowTemplateType { get; set; }

#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).

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

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.

See Also