SuperAPI AI 工具集

wpf-rule-converter-patterns

编程与开发

查看项目

更新于 11-06 03:57

技能介绍

该技能面向 WPF 开发中 IValueConverter 的实现规范,适用于 wpf-dev-pack 项目。

主要能力与使用方式:

一、MarkupExtension 单例模式。每个转换器同时实现 MarkupExtension 与 IValueConverter,ProvideValue 返回同一个共享实例。由于转换器无状态,共享实例是安全的,并可避免 ResourceDictionary 资源条目杂乱。技能强调只采用这一种模式,不要额外暴露静态 Instance 属性。示例中定义抽象基类 ConverterMarkupExtension<T>(T 为 class, new()),内部用 Lazy<T> 持有单例,ProvideValue 返回 _converter.Value,Convert 为抽象方法,ConvertBack 默认抛出 NotSupportedException。具体转换器如 BoolToVisibilityConverter 继承该基类并用 sealed 修饰。XAML 中可直接写 Converter={converters:BoolToVisibilityConverter},无需资源声明。

二、纯函数要求。Convert 不得有副作用(不写字段、服务或 ViewModel),不依赖外部状态(无静态可变状态,Convert 内不使用 DateTime.Now),相同输入必须产生相同输出。若转换逻辑需要外部上下文,应通过 ConverterParameter 或 IMultiValueConverter 的 MultiBinding 传入。

三、null 与 UnsetValue 处理。Convert 的第一步必须同时判断 value 为 null 或等于 DependencyProperty.UnsetValue。返回 DependencyProperty.UnsetValue 可告知 WPF 使用属性默认值,而不是抛出绑定错误;也可返回安全默认值。示例中 BoolToVisibilityConverter 对 null/UnsetValue 返回 Visibility.Collapsed,并支持参数 "Invert"/"invert" 反转布尔判断。

四、ControlTemplate 中的 TemplateBinding 与 Binding。在 ControlTemplate 内引用模板父级属性应使用 TemplateBinding,它是轻量单向绑定,避免完整 Binding 对象的开销;不要使用带 RelativeSource=TemplatedParent 的 Binding。仅当需要双向绑定,或需要对模板父级属性应用转换器时,才使用带 RelativeSource=TemplatedParent 的 Binding,因为 TemplateBinding 仅支持单向且不能直接配合转换器。

适用场景:WPF 控件模板、绑定值转换、布尔到可见性等常见转换逻辑的规范化实现。限制:资料未提供更多平台或版本要求,也未说明性能数据或收费信息。