.NET Support
Similarly to the other controls in UI for WPF, RadRichTextBox can be used in .NET 6 and later applications.
This article describes the differences with the .NET Framework version you might encounter.
Assembly References in .NET 6 and Later
To use RadRichTextBox in a .NET 6 or later project, 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 a 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 .Net 6 and later versions 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:
<!-- old path -->
pack://application:,,,/Telerik.Windows.Controls.RichTextBox;component/*
<!-- new path -->
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 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" />