.NET Core Support
Similarly to the other controls in UI for WPF, RadRichTextBox
can be used in .NET Core applications.
This article describes the differences with the .NET Framework version you might encounter.
Assembly References
To use RadRichTextBox, you need to add references to the following assemblies:
- Telerik.Windows.Controls
- Telerik.Windows.Controls.RichTextBox
- Telerik.Windows.Data
- Telerik.Windows.Documents.Core
To use the built-in UI, you should add references to the following assemblies:
- Telerik.Windows.Controls.Input
- Telerik.Windows.Controls.Navigation
- Telerik.Windows.Controls.ImageEditor
- Telerik.Windows.Controls.RibbonView
Migration from .NET Framework
If you are migrating from .NET Framework, note that there are several changes made to the assemblies. Several DLLs are now merged in а new assembly that is named Telerik.Windows.Controls.RichTextBox.dll. These merged DLLs are the following ones:
- Telerik.Windows.Documents.dll
- Telerik.Windows.Controls.RichTextBoxUI.dll
- Telerik.Windows.Documents.FormatProviders.Html
- Telerik.Windows.Documents.FormatProviders.MsRichTextBoxXaml
- Telerik.Windows.Documents.FormatProviders.OpenXml
- Telerik.Windows.Documents.FormatProviders.Pdf
- Telerik.Windows.Documents.FormatProviders.Rtf
- Telerik.Windows.Documents.FormatProviders.Xaml
- Telerik.Windows.Documents.Proofing.Dictionaries.En-US
The associated .xaml files are changed respectively.
MEF is not supported by the .NetCore version of the RadRichTextBox control. For more information, check the MEF article.
Paths to Resources
Due to the merging of the assemblies, the resources' paths are modified as well. For example, the .NET Framework version uses paths like the following one: pack://application:,,,/Telerik.Windows.Controls.RichTextBoxUI;component/*. The alternative for using RadRichTextBox in .NET Core environment is:
pack://application:,,,/Telerik.Windows.Controls.RichTextBox;component/RichTextBoxUI/*
Reorganized Resource Dictionaries
When using implicit themes, you need to merge the XAML resources so you can have styling for the controls. RadRichTextBox for .NET Core needs the following resources:
<ResourceDictionary Source="/Telerik.Windows.Themes.VisualStudio2019;component/Themes/System.Windows.xaml" />
<ResourceDictionary Source="/Telerik.Windows.Themes.VisualStudio2019;component/Themes/Telerik.Windows.Controls.xaml" />
<ResourceDictionary Source="/Telerik.Windows.Themes.VisualStudio2019;component/Themes/Telerik.Windows.Controls.Input.xaml" />
<ResourceDictionary Source="/Telerik.Windows.Themes.VisualStudio2019;component/Themes/Telerik.Windows.Controls.Navigation.xaml" />
<ResourceDictionary Source="/Telerik.Windows.Themes.VisualStudio2019;component/Themes/Telerik.Windows.Controls.RibbonView.xaml" />
<ResourceDictionary Source="/Telerik.Windows.Themes.VisualStudio2019;component/Themes/Telerik.Windows.Controls.RichTextBox.xaml" />
<ResourceDictionary Source="/Telerik.Windows.Themes.VisualStudio2019;component/Themes/Telerik.Windows.Controls.ImageEditor.xaml" />