IValueConverter用于WPF绑定中的类型转换，需实现Convert（源→目标）和可选的ConvertBack（目标→源），后者仅在TwoWay/OneWayToSource绑定且用户交互修改目标时调用；转换器须为公开类、无参构造，通过x:Key声明为资源并在Binding中引用，注意处理null、类型安全、线程安全及避免耗时操作。
WPF中IValueConverter的基本用法
WPF绑定默认不支持类型自动转换，比如把DateTime转成“2024-03-15”字符串、把bool转成可见性Visibility，必须靠IValueConverter。它只有两个方法：Convert（绑定源→目标）和ConvertBack（目标→源），后者在单向绑定里可以返回Binding.DoNothing或直接抛NotSupportedException。
在XAML中声明并使用转换器的三步操作
转换器必须是公开类、有无参构造函数，且实例需作为资源引入XAML才能复用。常见错误是忘了加x:Key，或在Binding里写错资源名。
Windows 日历同步
下载
将提醒同步至 Windows/Outlook 日历。用户提及「提醒我」「设置提醒」「加到日历」「同步到日历」「日程」「calendar」「日历」时触发。支持Microsoft Graph API 设备代码流认证，无需 Web 服务器，直接写入用户 Outlook 日历。
- 定义转换器类（继承
IValueConverter），确保Convert处理null和非预期类型，避免运行时崩溃 - XAML中用
xmlns映射命名空间，再在Resources里声明：<local:BoolToVisibilityConverter x:Key="BoolToVis"/>
- 在
Binding中通过Converter={StaticResource BoolToVis}引用；若需传参，用ConverterParameter（值为object，注意类型匹配）
ConvertBack什么时候必须实现？
仅当绑定模式为TwoWay或OneWayToSource，且用户交互会修改目标属性（如TextBox.Text输入、CheckBox.IsChecked切换）时，ConvertBack才被调用。例如把日期字符串解析回DateTime，必须手动处理格式错误——DateTime.TryParse比Parse更安全。
- 如果只读显示，用
Mode=OneWay，ConvertBack可直接返回Binding.DoNothing - 若
ConvertBack逻辑复杂或不可逆（如哈希值转原文），应抛NotSupportedException并确保绑定模式不触发它 -
ConvertParameter不能直接传泛型或匿名对象，建议用string或简单枚举，避免XAML解析失败
调试IValueConverter常见卡点
转换器不生效，90% 是资源未正确定义或路径不对；静默失败（如绑定显示空白）往往是Convert返回null而目标属性不允许（如TextBlock.Text接受null但显示为空，Image.Source则直接异常）。
- 在
Convert开头加Debugger.Break()或日志，确认是否被调用 - 检查绑定路径是否正确：比如
{Binding Path=IsActive, Converter={StaticResource BoolToVis}}中IsActive属性必须存在且可访问 - WPF不会捕获转换器内的异常并吞掉，而是抛出
XamlParseException或InvalidOperationException，堆栈里通常含System.Windows.Data.BindingExpression - 避免在转换器里做耗时操作（如IO、网络请求），UI线程会卡顿；复杂逻辑建议提前计算好，或改用
IMultiValueConverter组合多个值
