SuperAPI AI 工具集

wpf-rule-mvvm-constraints

编程与开发

查看项目

更新于 10-18 02:39

技能介绍

MVVM Constraints 是一组用于 wpf-dev-pack 项目的规则,作用是强制实施严格的 MVVM 分层隔离,避免 ViewModel 层与 WPF 框架产生耦合。

用途 这些规则面向 WPF 项目的 ViewModel 层,明确哪些程序集引用、命名空间、类型和基类实现是被禁止或被允许的,从而在编译期和编码阶段保持层间分离。

禁止的 DLL 引用 ViewModel 项目不得引用以下程序集:WindowsBase.dll、PresentationFramework.dll、PresentationCore.dll。如果目标为 ViewModel 层的 .csproj 中出现这些引用,应立即移除。

禁止与允许的 using 语句 ViewModel 代码中不得出现 System.Windows、System.Windows.Controls、System.Windows.Data、System.Windows.Media、System.Windows.Input,其中 System.Windows.Input 不包含 ICommand,因为 ICommand 应改用 CommunityToolkit.Mvvm 提供的实现。允许使用的命名空间包括 System.Collections.ObjectModel、System.Collections.Generic、System.ComponentModel、CommunityToolkit.Mvvm.ComponentModel、CommunityToolkit.Mvvm.Input。

ViewModel 类型限制 ViewModel 的属性和构造函数参数只能使用 BCL 类型,例如 string、int、double、bool、decimal、DateTime、Guid;集合类型如 ObservableCollection<T>、List<T>、IEnumerable<T>;以及其他 ViewModel 或领域模型类型。禁止将 Brush、Visibility、ImageSource、Thickness 等 WPF 类型作为 ViewModel 属性暴露,这些值应在视图层通过转换器或触发器完成转换。

CommunityToolkit.Mvvm 的使用 所有 ViewModel 基类与命令优先使用 CommunityToolkit.Mvvm:继承 ObservableObject 或 ObservableRecipient;使用 [ObservableProperty] 标注可绑定属性,由源生成器生成代码;使用 [RelayCommand] 标注命令,代码同样通过源生成器生成;不得手写 INotifyPropertyChanged 或 ICommand 实现。

适用场景与限制 该技能适用于遵循 wpf-dev-pack 结构、需要保证 ViewModel 不依赖 WPF 框架的 .NET WPF 项目。资料未说明具体安装方式、配置参数、版本要求或运行机制,这些内容暂时未提供。