XafApplication.DatabaseUpdateMode Property

Specifies the mode of updating the database.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v18.2.dll

Declaration

C#

[Browsable(false)]
[DefaultValue(DatabaseUpdateMode.UpdateOldDatabase)]
public DatabaseUpdateMode DatabaseUpdateMode { get; set; }

VB.NET

<Browsable(False)>
<DefaultValue(DatabaseUpdateMode.UpdateOldDatabase)>
Public Property DatabaseUpdateMode As DatabaseUpdateMode

Property Value

Type	Default	Description
DatabaseUpdateMode	**UpdateOldDatabase**	A DatabaseUpdateMode enumeration value.

Available values:

Name	Description
Never	Specifies that the database is never updated. In this instance, update of the database should be performed manually on the database server.
UpdateDatabaseAlways	Specifies that the database is updated at every application run. Do not choose this mode when the Application Server is in use.
UpdateOldDatabase	Specifies that the database is updated when its version is older than the application version.

Remarks

Use this property to specify the mode for application database update. By default, the DatabaseUpdateMode.UpdateOldDatabase value is set for this property. However, the DatabaseUpdateMode.UpdateDatabaseAlways value is set in VB solution templates for the debug mode:

VB.NET

Public Class Program
   Public Shared Sub Main()
      '...
      Dim _application As MySolutionWindowsFormsApplication = _
      New MySolutionWindowsFormsApplication()
      If System.Diagnostics.Debugger.IsAttached Then
         _application.DatabaseUpdateMode = DatabaseUpdateMode.UpdateDatabaseAlways
      End If
      '...
    End Sub
End Class

This is done because of the difficulty in incrementing versions in VB projects.

Note

Do not set the DatabaseUpdateMode property to DatabaseUpdateMode.UpdateDatabaseAlways when the Application Server is in use.

For details on the database update process, refer to the Update Application and Database Versions using the ModuleInfo Table topic.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DatabaseUpdateMode 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.

VB.NET

XAF_how-to-customize-the-new-actions-items-list-e238/VB/CustomizeNewActionItemsListExample.Web/Global.asax.vb#L32

If System.Diagnostics.Debugger.IsAttached AndAlso WebApplication.Instance.CheckCompatibilityType = CheckCompatibilityType.DatabaseSchema Then
    WebApplication.Instance.DatabaseUpdateMode = DatabaseUpdateMode.UpdateDatabaseAlways
End If

XAF_how-to-use-the-entity-framework-model-first-in-xaf-e4374/VB/MySolution.Web/Global.asax.vb#L36

If System.Diagnostics.Debugger.IsAttached Then
    WebApplication.Instance.DatabaseUpdateMode = DatabaseUpdateMode.UpdateDatabaseAlways
End If

XAF_how-to-customize-an-aspnet-template-e4359/VB/CustomizeTemplate.Web/Global.asax.vb#L34

If System.Diagnostics.Debugger.IsAttached AndAlso WebApplication.Instance.CheckCompatibilityType = CheckCompatibilityType.DatabaseSchema Then
    WebApplication.Instance.DatabaseUpdateMode = DatabaseUpdateMode.UpdateDatabaseAlways
End If

XAF_how-to-calculate-a-master-property-based-on-values-from-a-details-collection-e305/VB/CalculatedPropertiesSolution.Web/Global.asax.vb#L41

If System.Diagnostics.Debugger.IsAttached AndAlso WebApplication.Instance.CheckCompatibilityType = CheckCompatibilityType.DatabaseSchema Then
    WebApplication.Instance.DatabaseUpdateMode = DatabaseUpdateMode.UpdateDatabaseAlways
End If

XAF_how-to-display-the-dxchart-widget-in-an-xaf-view-t381904/VB/DxSample.Web/Global.asax.vb#L41

If System.Diagnostics.Debugger.IsAttached AndAlso WebApplication.Instance.CheckCompatibilityType = CheckCompatibilityType.DatabaseSchema Then
    WebApplication.Instance.DatabaseUpdateMode = DatabaseUpdateMode.UpdateDatabaseAlways
End If

C#

XAF_how-to-customize-the-new-actions-items-list-e238/CS/CustomizeNewActionItemsListExample.Win/Program.cs#L29

if(System.Diagnostics.Debugger.IsAttached && winApplication.CheckCompatibilityType == CheckCompatibilityType.DatabaseSchema) {
    winApplication.DatabaseUpdateMode = DatabaseUpdateMode.UpdateDatabaseAlways;
}

XAF_how-to-customize-an-aspnet-template-e4359/CS/CustomizeTemplate.Web/Global.asax.cs#L34

if(System.Diagnostics.Debugger.IsAttached && WebApplication.Instance.CheckCompatibilityType == CheckCompatibilityType.DatabaseSchema) {
    WebApplication.Instance.DatabaseUpdateMode = DatabaseUpdateMode.UpdateDatabaseAlways;
}

XAF_how-to-calculate-a-master-property-based-on-values-from-a-details-collection-e305/CS/CalculatedPropertiesSolution.Web/Global.asax.cs#L39

if(System.Diagnostics.Debugger.IsAttached && WebApplication.Instance.CheckCompatibilityType == CheckCompatibilityType.DatabaseSchema) {
    WebApplication.Instance.DatabaseUpdateMode = DatabaseUpdateMode.UpdateDatabaseAlways;
}

XAF_how-to-display-the-dxchart-widget-in-an-xaf-view-t381904/CS/DxSample.Web/Global.asax.cs#L39

if(System.Diagnostics.Debugger.IsAttached && WebApplication.Instance.CheckCompatibilityType == CheckCompatibilityType.DatabaseSchema) {
    WebApplication.Instance.DatabaseUpdateMode = DatabaseUpdateMode.UpdateDatabaseAlways;
}

xaf-win-web-open-detail-view-when-grid-row-is-clicked-in-the-dashboard/CS/ShowDetailViewFromDashboard.Web/Global.asax.cs#L39

if(System.Diagnostics.Debugger.IsAttached && WebApplication.Instance.CheckCompatibilityType == CheckCompatibilityType.DatabaseSchema) {
    WebApplication.Instance.DatabaseUpdateMode = DatabaseUpdateMode.UpdateDatabaseAlways;
}