泛型自定义控件BindableProperty绑定遇类型转换异常，如何实现？

错误原因 #

你遇到的System.InvalidCastException: 'Object must implement IConvertible.'异常，本质是泛型集合类不支持协变导致的：
虽然Dog实现了IAnimal，但ObservableRangeCollection<Dog>和ObservableRangeCollection<IAnimal>是完全独立的类型。只有带out关键字的泛型接口（比如IEnumerable<out T>）才支持协变，而ObservableRangeCollection是具体类，无法自动转换，因此绑定系统无法完成类型匹配。

泛型自定义控件的可行性 #

完全可以创建带泛型类型的自定义控件，且这种方式能从根本上解决类型匹配问题，以下是两种可行方案：

方案一：实现泛型自定义控件 #

将Overview改为泛型ContentView，让控件的集合类型与具体业务类型强绑定：

1. 泛型控件代码

public partial class Overview<TAnimal> : ContentView where TAnimal : IAnimal
{
    public static readonly BindableProperty AnimalsProperty =
        BindableProperty.Create(nameof(Animals), typeof(ObservableRangeCollection<TAnimal>), typeof(Overview<TAnimal>), null);

    public ObservableRangeCollection<TAnimal> Animals
    {
        get { return (ObservableRangeCollection<TAnimal>)GetValue(AnimalsProperty); }
        set { SetValue(AnimalsProperty, value); }
    }

    public Overview()
    {
        InitializeComponent();
    }
}

2. 在XAML中引用泛型控件
   在DogOverview的XAML里，通过x:TypeArguments指定泛型参数：

<ContentView xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:local="clr-namespace:YourNamespace"
             x:Class="DogOverview">
    <Grid>
        <local:Overview x:TypeArguments="local:Dog"
                        Animals="{Binding Dogs}" />
    </Grid>
</ContentView>

这种方式类型安全，无需额外转换，完全匹配ViewModel中的ObservableRangeCollection<Dog>类型。

方案二：使用协变接口兼容类型转换 #

如果不想使用泛型控件，可以将BindableProperty的类型改为支持协变的IEnumerable<IAnimal>，利用接口协变特性实现类型兼容：

1. 修改Overview控件的BindableProperty

public partial class Overview : ContentView
{
    public static readonly BindableProperty AnimalsProperty =
        BindableProperty.Create(nameof(Animals), typeof(IEnumerable<IAnimal>), typeof(Overview), null);

    public IEnumerable<IAnimal> Animals
    {
        get { return (IEnumerable<IAnimal>)GetValue(AnimalsProperty); }
        set { SetValue(AnimalsProperty, value); }
    }
}

由于ObservableRangeCollection<Dog>实现了IEnumerable<IAnimal>（IEnumerable<out T>支持协变），绑定系统可以自动完成类型匹配，不会抛出转换异常。

2. 可选：调整ViewModel属性类型
   如果需要在控件内修改集合，可以直接在ViewModel中将属性声明为ObservableRangeCollection<IAnimal>：

public partial class DogViewModel: ObservableObject 
{
    [ObservableProperty]
    private ObservableRangeCollection<IAnimal> _dogs = [];

    public DogViewModel()
    {
        // 直接添加Dog实例，因为Dog实现了IAnimal
        Dogs.Add(new Dog());
    }
}

总结 #

创建泛型自定义控件是完全可行的，方案一的泛型控件方式更推荐，它能保证类型安全，避免后续的类型转换问题，同时让控件的复用性更强。

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