MVVM+Service架构下Mapsui Map绑定Xaml失败的问题排查

核心问题解析 #

你遇到的System.InvalidCastException和XamlParseException，本质原因是Mapsui.UI.WinUI.MapControl的Map属性并非依赖属性，而XAML绑定语法{Binding}仅支持作用于依赖属性，XAML解析器无法处理非依赖属性的绑定操作，因此抛出异常。

解决方案一：代码后置手动赋值（最简单直接） #

修改XAML #

给Grid添加命名，方便后续获取DataContext：

<Grid x:Name="RootGrid">
    <Grid.DataContext>
        <viewmodels:MapViewModel/>
    </Grid.DataContext>
    <winui:MapControl x:Name="MyMap" VerticalAlignment="Stretch" HorizontalAlignment="Stretch"/>
</Grid>

修改MainWindow代码后置 #

在窗口加载完成后，手动将ViewModel的Map实例赋值给MapControl：

public sealed partial class MainWindow : Window
{
    public MainWindow()
    {
        this.InitializeComponent();
        this.Loaded += OnWindowLoaded;
    }

    private void OnWindowLoaded(object sender, Microsoft.UI.Xaml.RoutedEventArgs e)
    {
        var viewModel = (MapViewModel)RootGrid.DataContext;
        MyMap.Map = viewModel.Map;
    }
}

解决方案二：自定义支持绑定的MapControl（适合长期复用） #

如果需要在多个页面使用绑定方式，可以自定义一个包装控件，将Map属性转为依赖属性：

using Mapsui.UI.WinUI;
using Microsoft.UI.Xaml;

namespace YourNamespace
{
    public class BindableMapControl : MapControl
    {
        public static readonly DependencyProperty MapProperty =
            DependencyProperty.Register(nameof(Map), typeof(Mapsui.Map), typeof(BindableMapControl),
                new PropertyMetadata(null, OnMapPropertyChanged));

        public new Mapsui.Map Map
        {
            get => (Mapsui.Map)GetValue(MapProperty);
            set => SetValue(MapProperty, value);
        }

        private static void OnMapPropertyChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
        {
            var control = (BindableMapControl)d;
            control.BaseMap = (Mapsui.Map)e.NewValue;
        }
    }
}

在XAML中使用自定义控件 #

<Grid>
    <Grid.DataContext>
        <viewmodels:MapViewModel/>
    </Grid.DataContext>
    <local:BindableMapControl x:Name="MyMap" VerticalAlignment="Stretch" HorizontalAlignment="Stretch" Map="{Binding Map}"/>
</Grid>

额外优化：简化ViewModel代码 #

利用CommunityToolkit.Mvvm的[ObservableProperty]特性，替代手动编写的属性逻辑，减少冗余代码：

public partial class MapViewModel : ObservableObject
{
    [ObservableProperty]
    private Map _map;

    private readonly IMapService mapService;

    public MapViewModel()
    {
        mapService = new MapService();
        Map = mapService.GetMap();
    }
}

内容的提问来源于stack exchange，提问作者user21632369