MAUI中使用IValueConverter需三步：编写实现Convert/ConvertBack方法的转换器类、在XAML中注册为StaticResource、在Binding中引用；适用于类型转换、格式化及状态映射等场景。
在 MAUI 中使用 IValueConverter，核心就三步：写一个转换器类、注册为资源、在 Binding 中引用。它不是魔法，但能解决类型不匹配、格式化、状态映射等常见绑定难题。
写一个实现 IValueConverter 的类
转换器必须实现两个方法：Convert（源→目标）和 ConvertBack（目标→源）。是否需要 ConvertBack 取决于绑定模式：
- OneWay 绑定（比如显示文本、启用按钮）——只写
Convert就够了 - TwoWay 或 OneWayToSource（比如表单回填、滑块反向同步）——必须实现
ConvertBack
例如把 int 转成 bool（0 → false，非0 → true）：
public class IntToBoolConverter : IValueConverter
{
public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
=> (int)value != 0;
public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
=> (bool)value ? 1 : 0;
}
在 XAML 中注册并引用转换器
推荐统一放在 Converters/ 文件夹下，再通过命名空间引入：
- 在
ContentPage或App.xaml的根标签添加命名空间：xmlns:conv="clr-namespace:YourApp.Converters" - 在
Resources中声明实例，并给个x:Key：<conv:IntToBoolConverter x:Key="intToBool" /> - 在 Binding 表达式中用
{StaticResource intToBool}指定转换器
实际用法示例（让按钮随输入长度启用）：
<Entry x:Name="searchEntry" Text="" />
<Button Text="Search"
IsEnabled="{Binding Source={x:Reference searchEntry},
Path=Text.Length,
Converter={StaticResource intToBool}}" />
带参数的转换器（ConverterParameter）
有些逻辑需要动态控制，比如“把数字乘以 2”或“判断是否大于某阈值”，这时用 ConverterParameter 传参更灵活：
- 在 XAML 中写：
ConverterParameter="2"或ConverterParameter="{x:Static local:MyConstants.Threshold}" - 在
Convert方法里解析parameter，比如int.TryParse(parameter?.ToString(), out int factor) - 注意：
ConverterParameter是静态值，不能绑定；如需动态参数，考虑用MultiBinding+IMultiValueConverter
常见场景与注意事项
这些地方最容易踩坑，提前留意：
-
类型安全：
Convert中的value是 object，务必做类型检查或 try-cast，避免运行时异常 -
StringFormat 优先级：如果 Binding 同时设了
StringFormat和Converter，MAUI 先调Convert，再对返回值做格式化 -
货币/数字输入：
Entry.Text是 string，绑定decimal时别直接双向绑定，要用转换器处理空值、符号、千分位（参考CurrencyConverter示例） -
性能敏感场景：转换器是每次绑定更新都执行的，避免在
Convert里做耗时操作（如网络请求、大集合遍历）
基本上就这些。写好一个转换器，复用到多个页面甚至整个项目，比硬编码逻辑干净得多。
