Migrаting to .NET Core

This article shows how to migrate from an existing WPF .NET Framework project to a .NET Core one.

Before proceeding with this topic you can check if your application's code is compatible with .NET Core using the Microsoft Portability Analyzer tool.

  1. Create a new .NET Core 3.0 application using Visual Studio.

    Figure 1: Creating new project

    This VisualStudio template is available only with Visual Studio 2019. Otherwise, you will need to use the VS Command Prompt in order to create the project. This approach is shown in the following blog post.

    You can also use the Telerik Visual Studio Extensions to create a new project. Read more about this in the Integration section of the documentation.

  2. Add the existing files from the original project as linked files to the .NET Core project.

    Figure 2: Linking files from the original project

  3. Reference the Telerik assemblies built against .NET Core 3.0.

    If Telerik UI for WPF is installed on the machine, you can find the dlls in the "UI for WPF installation folder\Binaries\NetCore" folder. Otherwise, download the .zip file with the dlls or install them via the NuGet package manager.

    Figure 3: Checking if a Telerik assembly is built against .NET Core 3.0

Tips

  • If your project has images with Build Action set to Resource, change it to Embeded Resource or Content.

  • If you use the AssemblyInfo or App.manifest files from your original project, add them manually in the .NET Core project. The new project template uses a different approach and generates the same assembly attributes as part of the build process.

    Example 1: GenerateAssemblyInfo attribute

        <generateassemblyinfo>false</generateassemblyinfo> 
    
  • If you have referred to some references which are still not available in .NET Core as Windows.Composition, you can Include the Windows.Compatibility Pack with the command below executed via the Command Prompt from Visual Studio.

    dotnet add package Microsoft.Windows.Compatibility
  • The getting started experience in RadRichTextBox for .NET Core has been improved compared to its .NET Framework alternative. Check the .NET Core Support help topic for more details on the changes you might encounter.

See Also

In this article
Not finding the help you need? Improve this article