DatabaseVersionMismatchEventArgs.CompatibilityError Property

Specifies the error that has occured while checking the database and application compatibility.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public CompatibilityError CompatibilityError { get; set; }

VB.NET

Public Property CompatibilityError As CompatibilityError

Property Value

Type	Description
DevExpress.ExpressApp.Updating.CompatibilityError	A CompatibilityError object that represent the error that occurred.

Remarks

Use this property, to access the error that occurred while checking the compatibility of the application and its database. The error can be of the CompatibilityDatabaseIsOldError or CompatibilityUnableToOpenDatabaseError type.

This property returns null (Nothing in VB), if the error has not occurred.

Related GitHub Examples

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

C#

xaf-win-web-open-detail-view-when-grid-row-is-clicked-in-the-dashboard/CS/ShowDetailViewFromDashboard.Win/WinApplication.cs#L42

if(e.CompatibilityError != null && e.CompatibilityError.Exception != null) {
    message += "\r\n\r\nInner exception: " + e.CompatibilityError.Exception.Message;

xaf-how-to-access-the-master-detailview-information-from-a-nested-listview-controller/CS/WinWebSolution.Win/WinApplication.cs#L53

if(e.CompatibilityError != null && e.CompatibilityError.Exception != null) {
    message += "\r\n\r\nInner exception: " + e.CompatibilityError.Exception.Message;

XAF_how-to-allow-a-user-to-select-the-authentication-type-at-runtime-e2371/CS/E2371.Win/WinApplication.cs#L59

if(e.CompatibilityError != null && e.CompatibilityError.Exception != null) {
    message += "\r\n\r\nInner exception: " + e.CompatibilityError.Exception.Message;

xaf-how-to-extend-the-application-model/CS/ExtendModel.Win/WinApplication.cs#L57

if(e.CompatibilityError != null && e.CompatibilityError.Exception != null) {
    message += "\r\n\r\nInner exception: " + e.CompatibilityError.Exception.Message;

XAF_Non-Persistent-Objects-Reloading-Demo/CS/NonPersistentObjectsDemo.Win/WinApplication.cs#L60

if(e.CompatibilityError != null && e.CompatibilityError.Exception != null) {
    message += "\r\n\r\nInner exception: " + e.CompatibilityError.Exception.Message;

VB.NET

xaf-win-web-open-detail-view-when-grid-row-is-clicked-in-the-dashboard/VB/ShowDetailViewFromDashboard.Win/WinApplication.vb#L39

If e.CompatibilityError IsNot Nothing AndAlso e.CompatibilityError.Exception IsNot Nothing Then
    message &= ControlChars.CrLf & ControlChars.CrLf & "Inner exception: " & e.CompatibilityError.Exception.Message

xaf-how-to-access-the-master-detailview-information-from-a-nested-listview-controller/VB/WinWebSolution.Win/WinApplication.vb#L53

Dim message As String = "The application cannot connect to the specified database, " & "because the database doesn't exist, its version is older " & "than that of the application or its schema does not match " & "the ORM data model structure. To avoid this error, use one " & "of the solutions from the https://www.devexpress.com/kb=T367835 KB Article."
If e.CompatibilityError IsNot Nothing AndAlso e.CompatibilityError.Exception IsNot Nothing Then
    message += Microsoft.VisualBasic.Constants.vbCrLf & Microsoft.VisualBasic.Constants.vbCrLf & "Inner exception: " & e.CompatibilityError.Exception.Message

XAF_how-to-allow-a-user-to-select-the-authentication-type-at-runtime-e2371/VB/E2371.Win/WinApplication.vb#L56

If e.CompatibilityError IsNot Nothing AndAlso e.CompatibilityError.Exception IsNot Nothing Then
    message &= Constants.vbCrLf & Constants.vbCrLf & "Inner exception: " & e.CompatibilityError.Exception.Message

xaf-how-to-extend-the-application-model/VB/ExtendModel.Win/WinApplication.vb#L54

If e.CompatibilityError IsNot Nothing AndAlso e.CompatibilityError.Exception IsNot Nothing Then
    message &= vbCrLf & vbCrLf & "Inner exception: " & e.CompatibilityError.Exception.Message

XAF_Non-Persistent-Objects-Reloading-Demo/VB/NonPersistentObjectsDemo.Win/WinApplication.vb#L57

If e.CompatibilityError IsNot Nothing AndAlso e.CompatibilityError.Exception IsNot Nothing Then
    message &= vbCrLf & vbCrLf & "Inner exception: " & e.CompatibilityError.Exception.Message