BuyLog In
Breaking Change T932594
Visible to All Users

The DevExpress.XtraScheduler.Core assemblies for .NET Core 3 (WinForms & WPF) and .NET Framework apps have been split

What Changed

DevExpress.XtraScheduler.Core assemblies for .NET Core 3 (WinForms & WPF) and .NET Framework apps have been split into the following:

  • DevExpress.XtraScheduler.v20.2.Core.Desktop.dll for .NET Core 3 (WinForms & WPF) and .NET Framework apps
  • DevExpress.XtraScheduler.v20.2.Core.dll for .NET Standard.

Reasons for Change

These changes were done for easier project maintenance, clearer dependencies, and future code extension for .NET Core/.NET 5 apps and corresponding NuGet packages. These changes also help simplify common development tasks such as sharing Class Libraries with .NET Standard dependencies and cross-platform scheduler API (RecurrenceInfoXmlPersistenceHelper, ReminderInfoXmlPersistenceHelper, OccurrenceCalculator, RecurrenceInfo, ReminderInfo, etc.) across different Target Frameworks (learn more). We received lots of feedback from early .NET Core/.NET 5 adopters interested in these scenarios.

Impact on Existing Apps

These changes will not affect the majority of users, as our Project Converter tool will automatically add DevExpress.XtraScheduler.v20.2.Core.Desktop.dll and other required assembly references to individual projects. This change may affect your application if you are building a complex framework that relies on full assembly or type names.

This change may also affect WPF .NET Core apps with the scheduler control (including the legacy control) if the following APIs were used in XAML: WeekDays, DateTimeSavingMode, RecurrenceType, WeekOfMonth, TimeInterval, RecurrentAppointmentAction and RecurrenceRange API. Example:

XAML
<dxsch:SchedulerControl   
    xmlns:dxsch="http://schemas.devexpress.com/winfx/2008/xaml/scheduling"  
    xmlns:dxschcore="http://schemas.devexpress.com/winfx/2008/xaml/scheduling/core">  
    <dxsch:SchedulerControl.WorkDays>  
        <dxschcore:WeekDays>EveryDay</dxschcore:WeekDays>  
    </dxsch:SchedulerControl.WorkDays>  
</dxsch:SchedulerControl>

We urge you to thoroughly test it in your projects. If you happen to encounter breaking changes or uncovered scenarios, please contact us in the Support Center. Thank you in advance.

How to Update Existing Apps

In WPF .NET Core apps with the scheduler control (including the legacy control) where the WeekDays, DateTimeSavingMode, RecurrenceType, WeekOfMonth, TimeInterval, RecurrentAppointmentAction and RecurrenceRange API were used in XAML, consider the following changes:

XAML
<dxsch:SchedulerControl   
     xmlns:dxsch="http://schemas.devexpress.com/winfx/2008/xaml/scheduling"  
     xmlns:dxschcorebase="clr-namespace:DevExpress.XtraScheduler;assembly=DevExpress.XtraScheduler.v20.2.Core">  
     <dxsch:SchedulerControl.WorkDays>  
         <dxschcorebase:WeekDays>EveryDay</dxschcorebase:WeekDays>  
     </dxsch:SchedulerControl.WorkDays>  
</dxsch:SchedulerControl>

Take special note that the XML namespace dxschcore changed to CLR namespace dxschcorebase.

In ASP.NET web applications, register the XtraScheduler.v20.2.Core.Desktop library if you already use the XtraScheduler.v20.2.Core library.

web.config:

XML
<assemblies>
    <add assembly="DevExpress.XtraScheduler.v20.2.Core, Version=20.2.3.0, Culture=neutral, PublicKeyToken=..." />
    <add assembly="DevExpress.XtraScheduler.v20.2.Core.Desktop, Version=20.2.3.0, Culture=neutral, PublicKeyToken=..." />
</assemblies>

<pages>
  <controls>
    <add tagPrefix="dx" namespace="DevExpress.XtraScheduler" assembly="DevExpress.XtraScheduler.v20.2.Core, Version=20.2.3.0, Culture=neutral, PublicKeyToken=..." />
    <add tagPrefix="dx" namespace="DevExpress.XtraScheduler" assembly="DevExpress.XtraScheduler.v20.2.Core.Desktop, Version=20.2.3.0, Culture=neutral, PublicKeyToken=..." />
  </controls>
</pages>

Individual page:

ASPx
<%@ Register tagPrefix="dx" namespace="DevExpress.XtraScheduler" Assembly="DevExpress.XtraScheduler.v20.2.Core, Version=20.2.3.0, Culture=neutral, PublicKeyToken=..." %>
<%@ Register tagPrefix="dx" namespace="DevExpress.XtraScheduler" Assembly="DevExpress.XtraScheduler.v20.2.Core.Desktop, Version=20.2.3.0, Culture=neutral, PublicKeyToken=..." %>

See Also

Core - The DevExpress.ExpressApp.Scheduler assembly for .NET Core WinForms targets .NET Standard 2.0

Disclaimer: The information provided on DevExpress.com and affiliated web properties (including the DevExpress Support Center) is provided "as is" without warranty of any kind. Developer Express Inc disclaims all warranties, either express or implied, including the warranties of merchantability and fitness for a particular purpose. Please refer to the DevExpress.com Website Terms of Use for more information in this regard.

Confidential Information: Developer Express Inc does not wish to receive, will not act to procure, nor will it solicit, confidential or proprietary materials and information from you through the DevExpress Support Center or its web properties. Any and all materials or information divulged during chats, email communications, online discussions, Support Center tickets, or made available to Developer Express Inc in any manner will be deemed NOT to be confidential by Developer Express Inc. Please refer to the DevExpress.com Website Terms of Use for more information in this regard.