.NET MAUI编译报错：无法将'IsVisible'转换为BindableProperty

出现Error XFC0040: Cannot convert value "IsVisible" to "Microsoft.Maui.Controls.BindableProperty"错误，主要有以下几种常见原因：

• 自定义控件错误重定义IsVisible属性
  如果你在IconButton类中重新声明了IsVisible的BindableProperty，而非直接使用基类ImageButton继承来的属性，会导致XAML解析时无法匹配正确的BindableProperty类型。基类已提供IsVisible的绑定属性，自定义控件无需重复定义，否则会造成属性冲突。

• Style的TargetType与控件类型不匹配
  如果Style的TargetType未指定为自定义控件的完整类型（比如local:IconButton，假设自定义控件的命名空间是local），而是写成了ImageButton，在Setter/DataTrigger中针对IconButton操作属性时，可能出现属性解析错误。需确保TargetType准确指向自定义控件类型。

• XAML中属性引用逻辑冲突
  若自定义控件中存在与IsVisible同名的非绑定属性，会导致编译器无法将XAML中引用的IsVisible识别为BindableProperty。检查自定义控件代码，避免出现这类同名属性冲突。

举个错误示例：

public class IconButton : ImageButton
{
    // 错误：重复定义IsVisible的BindableProperty，基类已有该属性
    public static new readonly BindableProperty IsVisibleProperty =
        BindableProperty.Create(nameof(IsVisible), typeof(bool), typeof(IconButton), true);

    public new bool IsVisible
    {
        get => (bool)GetValue(IsVisibleProperty);
        set => SetValue(IsVisibleProperty, value);
    }
}

删除这段重复定义的代码，直接使用基类的IsVisible属性即可解决问题。

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