UWP中MapControl绑定ObservableCollection类型附加属性的元素添加异常问题

你遇到的这个问题我之前也碰到过——核心原因是你的附加属性只处理了集合的初始赋值，但没有监听集合自身的元素变更事件。毕竟MapControl是密封类没法派生，所以得通过监听集合的INotifyCollectionChanged事件，才能在ViewModel的集合添加/删除元素时，同步更新MapControl的Children。

下面是修正后的完整实现方案：

第一步：完善附加属性的C#代码 #

我们需要让附加属性不仅处理集合的首次赋值，还要订阅集合的变更事件，同步处理元素的增删改：

using System.Collections.Generic;
using System.Collections.Specialized;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls.Maps;

public static class MapExtensions
{
    // 定义附加属性，类型指定为INotifyCollectionChanged以兼容ObservableCollection
    public static readonly DependencyProperty MapChildrenProperty =
        DependencyProperty.RegisterAttached(
            "MapChildren",
            typeof(INotifyCollectionChanged),
            typeof(MapExtensions),
            new PropertyMetadata(null, OnMapChildrenChanged));

    public static INotifyCollectionChanged GetMapChildren(DependencyObject obj)
    {
        return (INotifyCollectionChanged)obj.GetValue(MapChildrenProperty);
    }

    public static void SetMapChildren(DependencyObject obj, INotifyCollectionChanged value)
    {
        obj.SetValue(MapChildrenProperty, value);
    }

    private static void OnMapChildrenChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        if (d is not MapControl mapControl) return;

        // 清理旧集合的事件监听，避免内存泄漏
        if (e.OldValue is INotifyCollectionChanged oldCollection)
        {
            oldCollection.CollectionChanged -= (s, args) => OnCollectionChanged(s, args, mapControl);
            mapControl.Children.Clear();
        }

        // 处理新集合
        if (e.NewValue is INotifyCollectionChanged newCollection)
        {
            // 先添加初始元素
            if (newCollection is IEnumerable<UIElement> elements)
            {
                foreach (var element in elements)
                {
                    if (!mapControl.Children.Contains(element))
                    {
                        mapControl.Children.Add(element);
                    }
                }
            }
            // 订阅集合变更事件，后续元素增删时同步更新
            newCollection.CollectionChanged += (s, args) => OnCollectionChanged(s, args, mapControl);
        }
    }

    private static void OnCollectionChanged(object? sender, NotifyCollectionChangedEventArgs e, MapControl mapControl)
    {
        switch (e.Action)
        {
            case NotifyCollectionChangedAction.Add:
                if (e.NewItems != null)
                {
                    foreach (UIElement item in e.NewItems)
                    {
                        if (!mapControl.Children.Contains(item))
                        {
                            mapControl.Children.Add(item);
                        }
                    }
                }
                break;
            case NotifyCollectionChangedAction.Remove:
                if (e.OldItems != null)
                {
                    foreach (UIElement item in e.OldItems)
                    {
                        mapControl.Children.Remove(item);
                    }
                }
                break;
            case NotifyCollectionChangedAction.Reset:
                mapControl.Children.Clear();
                if (sender is IEnumerable<UIElement> elements)
                {
                    foreach (var element in elements)
                    {
                        mapControl.Children.Add(element);
                    }
                }
                break;
            // 可选处理Move/Replace场景，根据你的业务需求决定是否实现
            case NotifyCollectionChangedAction.Replace:
                if (e.OldItems != null && e.NewItems != null)
                {
                    for (int i = 0; i < e.OldItems.Count; i++)
                    {
                        var oldItem = (UIElement)e.OldItems[i];
                        var newItem = (UIElement)e.NewItems[i];
                        var index = mapControl.Children.IndexOf(oldItem);
                        if (index != -1)
                        {
                            mapControl.Children.RemoveAt(index);
                            mapControl.Children.Insert(index, newItem);
                        }
                    }
                }
                break;
        }
    }
}

第二步：XAML中使用附加属性 #

在你的页面XAML里，引用这个附加属性即可：

<Page
    x:Class="YourProjectNamespace.YourMapPage"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:YourProjectNamespace"
    xmlns:maps="using:Windows.UI.Xaml.Controls.Maps">

    <Grid>
        <maps:MapControl
            x:Name="MainMap"
            local:MapExtensions.MapChildren="{Binding MapElementsCollection}"/>
    </Grid>
</Page>

第三步：ViewModel中的集合定义 #

确保你的ViewModel里使用ObservableCollection<T>（它实现了INotifyCollectionChanged），这样集合变更时才能触发附加属性的更新：

using System.Collections.ObjectModel;
using System.ComponentModel;
using Windows.UI.Xaml.Controls.Maps;

public class MapViewModel : INotifyPropertyChanged
{
    private ObservableCollection<UIElement> _mapElementsCollection = new();
    public ObservableCollection<UIElement> MapElementsCollection
    {
        get => _mapElementsCollection;
        set
        {
            _mapElementsCollection = value;
            OnPropertyChanged(nameof(MapElementsCollection));
        }
    }

    // 示例：添加新地图元素的方法
    public void AddNewMapPin()
    {
        var newPin = new MapIcon
        {
            Location = new Geopoint(new BasicGeoposition { Latitude = 39.9042, Longitude = 116.4074 }),
            Title = "北京"
        };
        MapElementsCollection.Add(newPin);
    }

    public event PropertyChangedEventHandler? PropertyChanged;
    private void OnPropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

关键注意点 #

1. 集合类型必须实现INotifyCollectionChanged：只有ObservableCollection<T>或者自定义实现该接口的集合，才能触发变更事件，普通List是不行的。
2. 内存泄漏防范：代码中已经处理了旧集合的事件解绑，避免MapControl销毁后集合还持有引用导致内存泄漏。
3. 按需扩展变更类型：如果你的业务需要处理集合的Move、Replace操作，可以在OnCollectionChanged中补充对应的逻辑。

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