WPF 转换器

在 WPF 的数据绑定中，IValueConverter（值转换器）扮演着**"翻译官"的角色。它的核心作用是解决 ViewModel（后台数据）与 View（前台界面）之间 数据类型不匹配或显示格式不一致**的问题。

比如：后台有一个 bool 类型的属性表示"是否保存"，但界面上的按钮需要的是 Visibility（可见/隐藏）；或者后台是一个 DateTime 时间，界面只想显示"yyyy-MM-dd"格式的字符串。这时候就需要用到 IValueConverter。

下面为你详细介绍它的具体使用方法：

🛠️ 第一步：创建一个转换器类

你需要新建一个 C# 类，让它实现 IValueConverter 接口，并实现其中的两个方法：Convert 和 ConvertBack。

• Convert ：数据从 ViewModel → View 时调用（最常用）。
• ConvertBack ：数据从 View → ViewModel 时调用（仅在双向绑定 TwoWay 时需要）。

举个例子： 假设我们要把后台的 bool 值转换成界面的 Visibility（true 显示，false 隐藏）。

using System;
using System.Globalization;
using System.Windows;
using System.Windows.Data;

public class BoolToVisibilityConverter : IValueConverter
{
    // 正向转换：ViewModel (bool) -> View (Visibility)
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        if (value is bool boolValue)
        {
            return boolValue ? Visibility.Visible : Visibility.Collapsed;
        }
        return Visibility.Collapsed; // 默认情况
    }

    // 反向转换：View (Visibility) -> ViewModel (bool)
    // 如果是单向绑定，这个方法可以直接返回 null 或抛出异常
    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        if (value is Visibility visibility)
        {
            return visibility == Visibility.Visible;
        }
        return false;
    }
}

🖼️ 第二步：在 XAML 中声明资源

写好转换器后，需要在你的界面（Window 或 UserControl）的 <Resources> 里把它实例化出来，方便后面引用。

<Window x:Class="YourApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:YourApp"> <!-- 确保引入了转换器所在的命名空间 -->

    <Window.Resources>
        <!-- 声明转换器资源，给它起个名字（Key） -->
        <local:BoolToVisibilityConverter x:Key="BoolToVisibility"/>
    </Window.Resources>

    <!-- ... 其他界面代码 ... -->
</Window>

🔗 第三步：在 Binding 中使用转换器

最后，在具体的控件绑定时，通过 Converter={StaticResource ...} 来指定使用刚才定义的转换器。

<!-- 假设 ViewModel 里有个 IsSaving 的布尔属性 -->
<Button Content="保存中..." 
        Visibility="{Binding IsSaving, Converter={StaticResource BoolToVisibility}}" />

这样，当 IsSaving 为 true 时，按钮就会自动显示；为 false 时，按钮就会自动隐藏。

💡 进阶技巧：带参数的转换器 (ConverterParameter)

如果你希望同一个转换器能处理不同的逻辑（比如 true 的时候是隐藏而不是显示），可以使用 ConverterParameter 传递参数。

XAML 写法：

<TextBlock Text="提示信息" 
           Visibility="{Binding IsAdmin, Converter={StaticResource BoolToVisibility}, ConverterParameter=Inverse}" />

C# 转换器里的接收：

public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
{
    bool boolValue = (bool)value;
    
    // 如果传入了 "Inverse" 参数，就反转逻辑
    if (parameter?.ToString() == "Inverse")
    {
        boolValue = !boolValue;
    }
    
    return boolValue ? Visibility.Visible : Visibility.Collapsed;
}

⚠️ 避坑指南

1. 空值安全 ：在 Convert 方法里，一定要先判断 value 是否为 null，以及类型是否正确（可以用 is 关键字），防止程序崩溃。
2. 失败的处理 ：如果转换失败或不支持，建议返回 DependencyProperty.UnsetValue，而不是直接抛异常，这样 WPF 会自动去使用你设置的 FallbackValue（备用值）。