.NET MAUI转换器报错：未找到Converter属性/绑定属性/事件

架构老林

2026-6-13

问题原因与解决办法

错误根源

你遇到的这个报错，核心原因是你的BoolToTextConverter类没有实现.NET MAUI绑定系统要求的IValueConverter接口。XAML绑定系统只能识别实现了该接口的类作为合法值转换器，否则会判定你使用的Converter属性无效，抛出找不到对应属性或类型不匹配的错误。

解决步骤

修改你的转换器类，让它继承IValueConverter接口，并确保引用正确的命名空间：

using Microsoft.Maui.Controls;
using System.Globalization;

namespace InSim.Util.Converter
{
    public class BoolToTextConverter : IValueConverter // 添加接口继承
    {
        // parameter format: "TrueText|FalseText"
        public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
        {
            if (value is not bool boolean)
                return string.Empty;

            if (parameter is string paramString)
            {
                var parts = paramString.Split('|');
                if (parts.Length == 2)
                    return boolean ? parts[0] : parts[1];
            }

            // Fallback if no parameter provided or format is incorrect
            return boolean ? "True" : "False";
        }

        public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
        {
            // Optional: Implement if needed for two-way binding
            return Binding.DoNothing;
        }
    }
}