SuperAPI AI 工具集

wpf-rule-view-viewmodel-wiring-communitytoolkit

编程与开发

查看项目

更新于 10-18 02:39

技能介绍

本条目是一套 WPF 中 View 与 ViewModel 连接方式的规则说明,适用于以 CommunityToolkit.Mvvm 作为活动 MVVM 框架的项目。其组合风格为 ViewModel First 组合加有状态 ViewModel,具体做法是 Mappings.xaml 配合隐式 DataTemplate。

核心原则:DataTemplate 只写 DataType、不写 x:Key,以便按类型自动匹配;Mappings.xaml 必须合并进 Application.Resources;绑定到 ContentControl.Content 的是 ViewModel 实例而非类型;View 会自动获得该 ViewModel 作为 DataContext,无需另行连接;ViewModel 类型匹配为精确匹配,不考虑继承关系。

使用方式:在 Mappings.xaml 中用 DataTemplate(DataType 指向某个 ViewModel 类型,内容为对应 View)登记映射,并在 App.xaml 的 Application.Resources 中合并该字典;主窗口 ViewModel 暴露 CurrentViewModel 属性并用 RelayCommand 切换实例,MainWindow.xaml 中把 ContentControl 的 Content 绑定到 CurrentViewModel;各 View 实现为 UserControl,可用 d:DataContext 提供设计时支持。

对于文件夹树、组织架构等递归数据,可用 HierarchicalDataTemplate 并通过 ItemsSource 绑定子项,叶子节点则使用普通 DataTemplate;HierarchicalDataTemplate 适合 TreeView、Menu、MenuItem 等层级控件,普通 DataTemplate 适合 ContentControl 承载的扁平数据。文中还给出了推荐的工程目录结构,将 Views、App、MainWindow、Mappings.xaml 放在 WPF 应用项目中,ViewModel 放在独立类库项目中。

限制与禁止项:不得使用 prism:ViewModelLocator.AutoWireViewModel="True";不得在 View 的 code-behind 中写 DataContext = new XxxViewModel();不得在 UserControl.DataContext 中直接嵌入 ViewModel 实例;不得使用命名约定、反射等其他匹配机制;ViewModel 中不得出现 System.Windows.* 类型(ICommand 除外);不得采用瞬时 ViewModel 加外部状态管理器的无状态 VM 模式;不得将本 Mappings.xaml 路径与 Prism RegionManager 混用。文中同时说明,早期插件文档曾将这一模式标注为 View First,该标注与微软定义不符,已在 v1.6.4 更正为 ViewModel First,实际代码规则未变。