FrameworkSettings.DefaultSettingsCompatibilityMode Property
Sets configuration options and feature toggles to match the default behavior of the specified version of DevExpress frameworks and libraries.
Namespace: DevExpress.ExpressApp
Assembly:
DevExpress.ExpressApp.v26.1.dll
Declaration
public static FrameworkSettingsCompatibilityMode DefaultSettingsCompatibilityMode { get; set; }
Public Shared Property DefaultSettingsCompatibilityMode As FrameworkSettingsCompatibilityMode
Property Value
| Type |
Description |
| FrameworkSettingsCompatibilityMode |
The version of DevExpress frameworks and libraries. XAF sets configuration options and feature toggles to match the selected version’s default behavior.
|
Available values:
| Name |
Description |
|
v20_1
|
Does not enable any configuration options or feature toggles.
|
|
v20_2
|
Enables the following configuration options and feature toggles:
DevExpress.Persistent.BaseImpl.BaseObject.OidInitializationMode = AfterConstructionDevExpress.ExpressApp.BaseObjectSpace.ThrowExceptionForNotRegisteredEntityType = trueDevExpress.ExpressApp.DetailView.UseAsyncLoading = trueDevExpress.ExpressApp.XafApplication.LinkNewObjectToParentImmediately = falseDevExpress.ExpressApp.XafApplication.OptimizedControllersCreation = trueDevExpress.ExpressApp.Utils.ImageLoader.UseSvgImages = trueDevExpress.ExpressApp.Win.WinApplication.UseLightStyle = true`DevExpress.ExpressApp.Win.WinApplication.ExecuteStartupLogicBeforeClosingLogonWindow = trueDevExpress.ExpressApp.Win.WinApplication.UseOldTemplates = falseDevExpress.ExpressApp.Xpo.XPObjectSpace.TrackPropertyModifications = true
|
|
v21_1
|
Extends v20_2 with the following configuration options and feature toggles:
|
|
v21_2
|
Extends the v21_1 with the following configuration options and feature toggles:
|
|
v22_1
|
Extends v21_2 with the following configuration options and feature toggles:
DevExpress.ExpressApp.Blazor.BlazorApplication.EnableDefaultSelectionDependencyType = true
|
|
v22_2
|
Enables the same configuration options and feature toggles as v22_1.
|
|
v23_1
|
Extends v22_2 with the following configuration options and feature toggles:
DevExpress.ExpressApp.Blazor.SystemModule.BlazorModificationsController.ShowSaveAndCloseActionInDetailView = trueDevExpress.ExpressApp.Blazor.SystemModule.BlazorModificationsController.ShowSaveAndNewActionInDetailView = trueDevExpress.ExpressApp.Blazor.SystemModule.CloseDetailViewController.ShowCloseActionInDetailView = falseDevExpress.ExpressApp.Blazor.SystemModule.BlazorNewObjectViewController.ShowNewObjectActionInDetailView = false
|
|
v23_2
|
Extends v23_1 with the following configuration options and feature toggles:
DevExpress.ExpressApp.Blazor.SystemModule.BlazorModificationsController.ShowSaveButtonsInPopup = trueDevExpress.ExpressApp.Blazor.SystemModule.PopupWindowTemplateClosingController.ShowCloseButtonInPopup = trueDevExpress.ExpressApp.Blazor.SystemModule.PopupWindowTemplateSizeController.AllowPopupDragAndResize = true
|
|
v24_1
|
Extends v23_2 with the following configuration options and feature toggles:
DevExpress.ExpressApp.ReportsV2.Blazor.ReportsBlazorModuleV2.ReportViewerType = DxReportViewerDevExpress.Persistent.AuditTrail.ObjectAuditProcessor.ExcludeNonPersistentFromAudit = true
|
|
v24_2
|
Sets the following configuration options and feature toggles:
|
|
v25_1
|
Enables the same configuration options and feature toggles as v24_2.
|
|
v25_2
|
Enables the same configuration options and feature toggles as v24_2.
|
|
v26_1
|
Specifies the following configuration options and feature toggles:
|
|
Latest
|
Enables configuration options and feature toggles that correspond to the latest version. We update this value with each release.
|
Set the DefaultSettingsCompatibilityMode property to DevExpress version to retain this version’s feature toggles and configuration options when you update an application.
If you want to automatically enable all the options for the latest version, set the DefaultSettingsCompatibilityMode to Latest (the Template Kit sets this value for all applications). In this case, you do not need to specify the options individually or check their compatibility. If some of these options cause issues with your application, you can change their values after you initialize the application. Options specified directly in code have a higher priority than DefaultSettingsCompatibilityMode.
The following code snippets specify this property in your applications:
File: MySolution.Win\Program.cs(.vb)
using DevExpress.ExpressApp;
// ...
public class Program {
static void Main(string[] arguments) {
FrameworkSettings.DefaultSettingsCompatibilityMode = FrameworkSettingsCompatibilityMode.v25_1;
// ...
MySolutionWinApplication winApplication = new MySolutionWinApplication();
// change a feature toggle value here
// ...
}
// ...
}
Imports DevExpress.ExpressApp
' ...
Public Class Program
Public Shared Sub Main(ByVal arguments() As String)
FrameworkSettings.DefaultSettingsCompatibilityMode = FrameworkSettingsCompatibilityMode.v20_2
' ...
Dim winApplication As New MySolutionWinApplication()
' change a feature toggle value here
' ...
End Sub
' ...
End Class
ASP.NET Core Blazor Application
File: MySolution.Blazor\Program.cs
using DevExpress.ExpressApp;
// ...
public class Program {
public static void Main(string[] arguments) {
FrameworkSettings.DefaultSettingsCompatibilityMode = FrameworkSettingsCompatibilityMode.v25_1;
// change a feature toggle value here
// ...
}
// ...
}
The following code snippets (auto-collected from DevExpress Examples) contain references to the DefaultSettingsCompatibilityMode property.
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.
See Also