syncfusion-maui-migration

Syncfusion Xamarin.Forms 到 .NET MAUI 迁移

一份全面的指南，介绍如何将 Syncfusion 组件从 Xamarin.Forms 迁移到 .NET MAUI。本指南详细说明了所有 Syncfusion 组件类别中的 API 变更、命名空间更新、属性重命名和迁移模式。

何时使用此指南

在以下情况下使用此指南：

• 将 Syncfusion Xamarin.Forms 组件迁移到 .NET MAUI
• 将命名空间从 Syncfusion.*.XForms 更新为 Syncfusion.Maui.*
• 了解 Xamarin 和 MAUI 版本之间的 API 变更
• 查找 Xamarin 组件在 MAUI 中的对应项
• 解决迁移期间的重大变更问题
• 更新属性名称、事件和枚举
• 在 MauiProgram.cs 中注册处理程序
• 更新 NuGet 包引用
• 修复升级后的编译错误
• 了解哪些 Xamarin 组件已弃用

迁移概述

Syncfusion 持续提供 .NET MAUI 控件，同时尽可能减少相对于 Xamarin.Forms 的重大变更。所有必要的 Xamarin.Forms 控件和功能均已在 .NET MAUI 中全面提供，可实现顺畅、可靠且无缝的迁移体验。

迁移要点：

• 命名空间模式：Syncfusion.XForms.* → Syncfusion.Maui.*
• 处理程序注册：必须在 MauiProgram.cs 中使用 .ConfigureSyncfusionCore() 注册
• API 一致性：大多数 API 均予以保留，部分名称为符合 MAUI 一致性要求而进行了更改
• 包名称：从 Syncfusion.Xamarin.* 更新为 Syncfusion.Maui.*
• 重大变更：属性重命名（例如，BackgroundColor → Background）、枚举更新
• 已弃用的组件：部分组件已由原生 MAUI 控件取代（SfBorder、SfGradientView）

文档和导航指南

迁移概述和组件索引

📄 阅读： references/migration-overview.md

• 完整的组件映射表（Xamarin → MAUI）
• 迁移路线图和时间表
• 通用迁移工作流
• 包和命名空间变更概述
• 已弃用的组件及其替代项
• 版本兼容性信息

图表迁移

📄 阅读： references/charts-migration.md

• SfCartesianChart（由 SfChart 迁移而来）
• SfCircularChart 迁移
• SfPolarChart 迁移
• SfFunnelChart 迁移
• SfPyramidChart 迁移
• 图表命名空间和枚举更新
• 系列和坐标轴属性变更
• 图例和工具提示更新

仪表迁移

📄 阅读： references/gauges-migration.md

• SfRadialGauge（由 SfCircularGauge 迁移而来）
• SfLinearGauge 迁移
• SfDigitalGauge 迁移
• 指针和刻度属性映射
• 注释变更
• 样式更新

数据控件迁移

📄 阅读： references/data-controls-migration.md

• SfDataGrid 迁移（选择、排序、筛选）
• SfDataForm 迁移
• SfTreeView 迁移
• SfTreeMap 迁移
• 属性重命名（SelectedItem → SelectedRow）
• 事件处理程序更新
• 枚举变更（ColumnSizer → ColumnWidthMode）

日历和日程安排控件

📄 阅读： references/calendar-scheduling-migration.md

• SfCalendar 迁移（选择方式变更）
• SfScheduler（由 SfSchedule 迁移而来）
• SfDatePicker 迁移
• SfTimePicker 迁移
• SfDateTimeRangePicker 更新
• SfDateTimeRangeSelector（由 SfDateTimeRangeNavigator 迁移而来）
• 约会管理差异

输入和选择器控件

📄 阅读： references/input-picker-migration.md

• SfMaskedEntry（由 SfMaskedEdit 迁移而来）
• SfComboBox 迁移
• SfAutocomplete 迁移
• SfPicker 迁移
• SfTextInputLayout 迁移
• 输入验证变更
• 下拉行为更新

导航和列表控件

📄 阅读： references/navigation-list-migration.md

• SfListView 迁移
• SfSegmentedControl 迁移
• SfAccordion 迁移
• SfExpander 迁移
• SfTabView 迁移
• 选择处理变更
• ItemTemplate 更新

进度和视觉指示器

📄 阅读： references/progress-visual-migration.md

• SfLinearProgressBar 迁移
• SfCircularProgressBar 迁移
• SfStepProgressBar 迁移
• SfShimmer 迁移
• SfBarcodeGenerator（源自 SfBarcode）
• 动画和样式更新
• 进度状态变更

布局和容器控件

📄 阅读： references/layout-container-migration.md

• SfBackdropPage 迁移
• SfCards 迁移
• SfParallaxView 迁移
• SfPopup（源自 SfPopUpLayout）
• 布局属性变更
• 已弃用的控件（SfBorder → Border，SfGradientView → Gradients）

交互和绘图控件

📄 阅读： references/interactive-drawing-migration.md

• SfSignaturePad 迁移
• SfChat 迁移
• SfSlider 迁移
• SfRangeSlider 迁移
• SfRadialMenu 迁移
• 下拉刷新迁移
• 触摸和手势变更

地图和位置服务

📄 阅读： references/maps-migration.md

• SfMaps 迁移
• 图层配置变更
• 标记和数据绑定更新
• 形状文件处理
• GeoJSON 支持变更

常见迁移模式

📄 阅读： references/common-migration-patterns.md

• 在 MauiProgram.cs 中注册处理程序
• NuGet 包名称变更
• 所有控件的命名空间模式
• 常见属性重命名
• 颜色和画笔 API 变更
• 事件参数类更新
• 枚举重命名模式
• 各版本的破坏性变更
• 迁移故障排除指南