Migration Overview: Syncfusion® .NET MAUI to Syncfusion® Toolkit for .NET MAUI

26 May 20253 minutes to read

To ensure a smooth migration from Syncfusion® .NET MAUI to the Syncfusion® Toolkit for .NET MAUI controls, we have designed the Toolkit components to closely resemble those in Syncfusion® .NET MAUI. This approach minimizes the changes required during migration, with the primary difference being the use of toolkit-specific namespaces.
By preserving similar APIs and functionality, developers can easily update their existing projects to use the new toolkit with minimal code modifications. Refer to the table below for a detailed overview of the necessary changes:

XAML Namespaces

Controls Syncfusion® .NET MAUI Namespace Syncfusion® Toolkit for .NET MAUI Namespace Description
SfAccordion xmlns:accordion="clr-namespace:Syncfusion.Maui.Accordion;assembly=Syncfusion.Maui.Expander" xmlns:accordion="clr-namespace:Syncfusion.Maui.Toolkit.Accordion;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfAccordion control.
SfButton xmlns: button ="clr-namespace:Syncfusion.Maui.Buttons;assembly=Syncfusion.Maui.Buttons" xmlns:button ="clr-namespace:Syncfusion.Maui.Toolkit.Buttons;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfButton control.
SfCalendar xmlns: calendar ="clr-namespace:Syncfusion.Maui.Calendar;assembly=Syncfusion.Maui.Calendar" xmlns:calendar="clr-namespace:Syncfusion.Maui.Toolkit.Calendar;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfCalendar control.
SfCards xmlns:cards="clr-namespace:Syncfusion.Maui.Cards;assembly=Syncfusion.Maui.Cards" xmlns:cards="clr-namespace:Syncfusion.Maui.Toolkit.Cards;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfCards control.
SfCarousel xmlns: carousel ="clr-namespace:Syncfusion.Maui.Carousel;assembly=Syncfusion.Maui.Carousel" xmlns:carousel="clr-namespace:Syncfusion.Maui.Toolkit.Carousel;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfCarousel control.
SfCartesianChart, SfCircularChart, SfFunnelChart, SfPolarChart, and SfPyramidChart xmlns:chart="clr-namespace:Syncfusion.Maui.Charts;assembly=Syncfusion.Maui.Charts" xmlns:chart="clr-namespace:Syncfusion.Maui.Toolkit.Charts;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfCartesianChart, SfCircularChart, SfFunnelChart, SfPolarChart, and SfPyramidChart controls.
SfCircularProgressBar xmlns:progressBar="clr-namespace:Syncfusion.Maui.ProgressBar;assembly=Syncfusion.Maui.ProgressBar" xmlns:progressBar="clr-namespace:Syncfusion.Maui.Toolkit.ProgressBar;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfCircularProgressBar control.
SfChip xmlns:chip="clr-namespace:Syncfusion.Maui.Core;assembly=Syncfusion.Maui.Core" xmlns:chip="clr-namespace:Syncfusion.Maui.Toolkit.Chips;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfChip control.
SfEffectsView xmlns:effectsView="clr-namespace:Syncfusion.Maui.Core;assembly=Syncfusion.Maui.Core" xmlns:effectsView="clr-namespace:Syncfusion.Maui.Toolkit.EffectsView;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfEffectsView control.
SfExpander xmlns:expander="clr-namespace:Syncfusion.Maui.Expander;assembly=Syncfusion.Maui.Expander" xmlns:expander="clr-namespace:Syncfusion.Maui.Toolkit.Expander;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfExpander control.
SfLinearProgressBar xmlns:progressBar="clr-namespace:Syncfusion.Maui.ProgressBar;assembly=Syncfusion.Maui.ProgressBar" xmlns:progressBar="clr-namespace:Syncfusion.Maui.Toolkit.ProgressBar;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfLinearProgressBar control.
SfNavigationDrawer xmlns:navigationDrawer="clr-namespace:Syncfusion.Maui.NavigationDrawer;assembly=Syncfusion.Maui.NavigationDrawer" xmlns:navigationDrawer="clr-namespace:Syncfusion.Maui.Toolkit.NavigationDrawer;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfNavigationDrawer control.
SfNumericEntry xmlns:numericEntry ="clr-namespace:Syncfusion.Maui.Inputs;assembly=Syncfusion.Maui.Inputs" xmlns:numericEntry="clr-namespace:Syncfusion.Maui.Toolkit.NumericEntry;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfNumericEntry control.
SfNumericUpDown xmlns:numericUpDown ="clr-namespace:Syncfusion.Maui.Inputs;assembly=Syncfusion.Maui.Inputs" xmlns:numericUpDown="clr-namespace:Syncfusion.Maui.Toolkit.NumericUpDown;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfNumericUpDown control.
SfPicker xmlns:picker="clr-namespace:Syncfusion.Maui.Picker;assembly=Syncfusion.Maui.Picker" xmlns:picker="clr-namespace:Syncfusion.Maui.Toolkit.Picker;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfPicker control.
SfPopup xmlns:popup="clr-namespace:Syncfusion.Maui.Popup;assembly=Syncfusion.Maui.Popup" xmlns:popup="clr-namespace:Syncfusion.Maui.Toolkit.Popup;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfPopup control.
SfPullToRefresh xmlns:pullToRefreshControl="clr-namespace:Syncfusion.Maui.PullToRefresh;assembly=Syncfusion.Maui.PullToRefresh" xmlns:pullToRefreshControl="clr-namespace:Syncfusion.Maui.Toolkit.PullToRefresh;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfPullToRefresh control.
SfSegmentedControl xmlns:segmentedControl="clr-namespace:Syncfusion.Maui.Buttons;assembly=Syncfusion.Maui.Buttons" xmlns:segmentedControl="clr-namespace:Syncfusion.Maui.Toolkit.SegmentedControl;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfSegmentedControl.
SfShimmer xmlns:shimmer="clr-namespace:Syncfusion.Maui.Shimmer;assembly=Syncfusion.Maui.Core" xmlns:shimmer="clr-namespace:Syncfusion.Maui.Toolkit.Shimmer;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfShimmer control.
SfTabView xmlns:tabView="clr-namespace:Syncfusion.Maui.TabView;assembly=Syncfusion.Maui.TabView" xmlns:tabView="clr-namespace:Syncfusion.Maui.Toolkit.TabView;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfTabView control.
SfTextInputLayout xmlns:inputLayout="clr-namespace:Syncfusion.Maui.Core;assembly=Syncfusion.Maui.Core" xmlns:inputLayout="clr-namespace:Syncfusion.Maui.Toolkit.TextInputLayout;assembly=Syncfusion.Maui.Toolkit" Defines the XAML namespace for SfTextInputLayout control.

C# Namespaces

Controls Syncfusion® .NET MAUI Namespace Syncfusion® Toolkit for .NET MAUI Namespace Description
SfButton Syncfusion.Maui.Buttons Syncfusion.Maui.Toolkit.Buttons Defines the namespace for SfButton control.
SfCalendar Syncfusion.Maui.Calendar Syncfusion.Maui.Toolkit.Calendar Defines the namespace for SfCalendar control.
SfCards Syncfusion.Maui.Cards Syncfusion.Maui.Toolkit.Cards Defines the namespace for SfCards control.
SfCarousel Syncfusion.Maui.Carousel Syncfusion.Maui.Toolkit.Carousel Defines the namespace for SfCarousel control.
SfCartesianChart, SfCircularChart, SfFunnelChart, SfPolarChart, and SfPyramidChart Syncfusion.Maui.Charts Syncfusion.Maui.Toolkit.Charts Defines the namespace for SfCartesianChart, SfCircularChart, SfFunnelChart, SfPolarChart, and SfPyramidChart controls.
SfCircularProgressBar Syncfusion.Maui.ProgressBar Syncfusion.Maui.Toolkit.ProgressBar Defines the namespace for SfCircularProgressBar control.
SfChip Syncfusion.Maui.Core Syncfusion.Maui.Toolkit.Chip Defines the namespace for SfChip control.
SfEffectsView Syncfusion.Maui.Core Syncfusion.Maui.Toolkit.EffectsView Defines the namespace for SfEffectsView control.
SfLinearProgressBar Syncfusion.Maui.ProgressBar Syncfusion.Maui.Toolkit.ProgressBar Defines the namespace for SfLinearProgressBar control.
SfNavigationDrawer Syncfusion.Maui.NavigationDrawer Syncfusion.Maui.Toolkit.NavigationDrawer Defines the namespace for SfNavigationDrawer control.
SfNumericEntry Syncfusion.Maui.Inputs Syncfusion.Maui.Toolkit.NumericEntry Defines the namespace for SfNumericEntry control.
SfNumericUpDown Syncfusion.Maui.Inputs Syncfusion.Maui.Toolkit.NumericUpDown Defines the namespace for SfNumericUpDown control.
SfPicker Syncfusion.Maui.Picker Syncfusion.Maui.Toolkit.Picker Defines the namespace for SfPicker control.
SfPopup Syncfusion.Maui.Popup Syncfusion.Maui.Toolkit.Popup Defines the namespace for SfPopup control.
SfPullToRefresh Syncfusion.Maui.PullToRefresh Syncfusion.Maui.Toolkit.PullToRefresh Defines the namespace for SfPullToRefresh control.
SfSegmentedControl Syncfusion.Maui.Buttons Syncfusion.Maui.Toolkit.SegmentedControl Defines the namespace for SfSegmentedControl.
SfShimmer Syncfusion.Maui.Shimmer Syncfusion.Maui.Toolkit.Shimmer Defines the namespace for SfShimmer control.
SfTabView Syncfusion.Maui.TabView Syncfusion.Maui.Toolkit.TabView Defines the namespace for SfTabView control.
SfTextInputLayout Syncfusion.Maui.Core Syncfusion.Maui.Toolkit.TextInputLayout Defines the namespace for SfTextInputLayout control.
Common Syncfusion.Maui.Core.Hosting Syncfusion.Maui.Toolkit.Hosting Provides functionality for configure your .NET MAUI application through the AppHostBuilder.

C# Methods

Controls Syncfusion® .NET MAUI Syncfusion® Toolkit for .NET MAUI Description
Common ConfigureSyncfusionCore() ConfigureSyncfusionToolkit() Configures the implemented handlers in Syncfusion.Maui.Toolkit.