MvvmCross框架中的值转换器(Value Converters)深度解析-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00319/article/details/148552071

MvvmCross框架中的值转换器(Value Converters)深度解析

MvvmCross The .NET MVVM framework for cross-platform solutions, including Xamarin.iOS, Xamarin.Android, Windows and Mac. 项目地址: https://gitcode.com/gh_mirrors/mv/MvvmCross

什么是值转换器

在MvvmCross框架中，值转换器(Value Converters)是实现视图模型(ViewModel)与视图(View)之间数据转换的重要组件。它们负责将视图模型中的逻辑值转换为适合在用户界面中显示的值，或者将用户界面中的值转换回视图模型可理解的逻辑值。

核心接口与基础实现

MvvmCross中的值转换器都实现了IMvxValueConverter接口，该接口定义了两个关键方法：

public interface IMvxValueConverter
{
    object Convert(object value, Type targetType, object parameter, CultureInfo culture);
    object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture);
}

Convert方法：将ViewModel中的值转换为View可用的值
ConvertBack方法：将View中的值转换回ViewModel可用的值

对于只读UI元素(如标签、图片等)，通常只需要实现Convert方法即可。

简化开发：MvxValueConverter<TFrom,TTo>辅助类

为了简化开发，MvvmCross提供了MvxValueConverter<TFrom, TTo>基类，它处理了类型转换并提供了默认的ConvertBack实现。例如：

public class MyTimeAgoValueConverter : MvxValueConverter<DateTime, string>
{
    protected override string Convert(DateTime value, Type targetType, object parameter, CultureInfo cultureInfo)
    {
        var timeAgo = DateTime.UtcNow - value;
        if (timeAgo.TotalSeconds < 30) return "刚刚";
        if (timeAgo.TotalMinutes < 10) return "几分钟前";
        if (timeAgo.TotalMinutes < 60) return "不到一小时前";
        if (timeAgo.TotalMinutes < 24*60) return "今天";
        return "更早";
    }
}

参数与本地化支持

值转换器支持三个重要参数：

Type targetType：指示输出值的预期类型
CultureInfo cultureInfo：提供UI使用的文化信息
object parameter：允许在绑定声明中传递额外参数

参数传递示例：

<!-- XAML绑定示例 -->
<TextBlock Text="{Binding FullName, Converter={StaticResource Abbreviate}, ConverterParameter=12}"/>

值转换器的注册与使用

MvvmCross通过反射自动扫描并注册值转换器，遵循以下命名约定：

类名中的"Mvx"前缀和"ValueConverter"/"Converter"后缀会被移除
例如：Foo、FooValueConverter、FooConverter、MvxFooValueConverter都会被注册为"Foo"

可以通过重写Setup类中的FillValueConverters方法来自定义注册逻辑：

protected override void FillValueConverters(IMvxValueConverterRegistry registry)
{
    base.FillValueConverters(registry);
    registry.AddOrOverwrite("CustomName", new MySpecialConverter());
}

跨平台实现技巧

在Windows/Xamarin.Forms中使用

由于Windows平台的IValueConverter接口与MvvmCross的IMvxValueConverter略有不同，需要创建原生包装器：

public class NativeTruthConverter : MvxNativeValueConverter<TheTruthValueConverter>
{
}

然后在XAML中声明：

<converters:NativeTruthConverter x:Key="TheTruth" />
<TextBlock Text="{Binding HasAccepted, Converter={StaticResource TheTruth}}" />

平台特定实现

虽然推荐将值转换器放在共享项目中，但也可以在平台特定项目中实现特定功能，如图片加载或平台特定的布局调整。

常用内置值转换器

可见性转换器

MvvmCross提供了两个内置的可见性转换器：

MvxVisibilityValueConverter（注册名为"Visibility"）
MvxInvertedVisibilityValueConverter（注册名为"InvertedVisibility"）

它们支持以下类型的自动转换：

字符串：非空字符串为可见
数值：大于0为可见
布尔值：true为可见
其他类型：非null为可见

使用示例：

<!-- Android -->
local:MvxBind="Visibility Visibility(IsAvailable)"

<!-- iOS -->
set.Bind(field).For("Visibility").To(vm => vm.IsAvailable).WithConversion("Visibility");

<!-- Windows -->
Visibility="{Binding IsAvailable, Converter={StaticResource Visibility}}"

颜色转换器

MvvmCross提供了多种颜色转换器：

MvxNativeColorValueConverter（"NativeColor"）：将System.Drawing.Color转换为原生颜色
MvxRGBValueConverter（"RGB"）：将十六进制字符串转换为颜色
MvxRGBAValueConverter（"RGBA"）：同上，支持透明度
MvxARGBValueConverter（"ARGB"）：支持Alpha通道在前
MvxRGBIntColorConverter（"RGBIntColor"）：将整数值转换为颜色

使用示例：

<!-- Android -->
local:MvxBind="BackgroundColor NativeColor(ThemeColor)"

<!-- iOS -->
set.Bind(field).For(f => f.BackgroundColor).To(vm => vm.ThemeColor).WithConversion("NativeColor");

<!-- Windows -->
Fill="{Binding ThemeColor, Converter={StaticResource NativeColor}}"

性能优化建议

虽然值转换器的反射扫描对性能影响很小，但在大型应用中可以考虑：

禁用自动扫描，手动注册需要的转换器
重写FillValueConverters方法，不调用基类方法

protected override void FillValueConverters(IMvxValueConverterRegistry registry)
{
    // 不调用基类方法避免反射
    registry.AddOrOverwrite("Foo", new FooValueConverter());
    registry.AddOrOverwrite("Bar", new BarValueConverter());
}