Prism基础_命令（DelegateCommand）详解（工业级上位机专篇）

Prism基础_命令DelegateCommand详解工业级上位机专篇在工业级WPF上位机开发中命令Command是MVVM模式中处理用户交互的核心机制。按钮点击、菜单选择、设备启停、报警确认、参数保存等操作都应该通过Command实现而不是在View的Code-Behind中写事件处理代码。Prism提供的DelegateCommand以及泛型DelegateCommandT完美封装了ICommand接口让你以简洁、声明式的方式将ViewModel中的逻辑绑定到UI控件同时自动支持CanExecute动态启用/禁用按钮。这解决了工业痛点设备“启动”按钮只有在“无故障 已连接PLC”时才可用。异步操作如下发配方到PLC不会阻塞UI。权限控制、状态联动实时生效。代码可测试、可维护。1. DelegateCommand 基础用法所有命令都定义在ViewModel中继承BindableBase的ViewModel里直接使用。usingPrism.Commands;usingPrism.Mvvm;publicclassMachineControlViewModel:BindableBase{// 1. 无参数命令最常用publicDelegateCommandStartMachineCommand{get;privateset;}publicDelegateCommandStopMachineCommand{get;privateset;}// 2. 带参数命令例如选择产线IDpublicDelegateCommandintSelectLineCommand{get;privateset;}publicMachineControlViewModel(){// 初始化命令StartMachineCommandnewDelegateCommand(ExecuteStartMachine,CanExecuteStartMachine);StopMachineCommandnewDelegateCommand(ExecuteStopMachine);SelectLineCommandnewDelegateCommandint(ExecuteSelectLine);}// 执行方法privatevoidExecuteStartMachine(){// 发送PLC启动指令通过注入的IPlcService// _plcService.WriteStartBit();MachineStatus启动中...;}privatevoidExecuteStopMachine(){MachineStatus已停止;}privatevoidExecuteSelectLine(intlineId){CurrentLineIdlineId;// 加载对应产线参数}// CanExecute 方法决定按钮是否可用privateboolCanExecuteStartMachine(){returnIsPlcConnected!HasFaultMachineStatus!启动中...;}}2. XAML中的绑定方式!-- 按钮绑定命令 --ButtonContent启动设备Command{Binding StartMachineCommand}Width120Height40/!-- 带参数的命令例如ListBox选中项 --ListBoxItemsSource{Binding ProductionLines}ListBox.ItemTemplateDataTemplateButtonContent选择此产线Command{Binding DataContext.SelectLineCommand, RelativeSource{RelativeSource AncestorTypeListBox}}CommandParameter{Binding LineId}//DataTemplate/ListBox.ItemTemplate/ListBox进阶结合Converter实现按钮文字动态变化启动/停止切换。3. 动态启用/禁用CanExecute 核心价值工业上位机中按钮状态必须随实时状态变化自动更新。Prism的DelegateCommand支持以下方式自动刷新CanExecute方式一手动调用 RaiseCanExecuteChanged()privatevoidOnPlcStatusChanged(){StartMachineCommand.RaiseCanExecuteChanged();// 通知UI重新评估CanExecute}方式二使用 ObservesPropertyPrism强大特性强烈推荐publicMachineControlViewModel(){StartMachineCommandnewDelegateCommand(ExecuteStartMachine,CanExecuteStartMachine).ObservesProperty(()IsPlcConnected)// 观察属性变化.ObservesProperty(()HasFault).ObservesProperty(()MachineStatus);}当被观察的属性通过SetProperty变化时CanExecute会自动重新计算按钮自动Enable/Disable。进阶观察集合属性Count等可手动订阅CollectionChanged事件后调用RaiseCanExecuteChanged()。或通过ObservesProperty(() MyCollection.Count)部分版本支持嵌套属性。4. 异步命令工业必备PLC下发、报表生成等耗时操作Prism支持异步执行避免UI卡顿。publicDelegateCommandSaveRecipeCommand{get;privateset;}publicMachineControlViewModel(){// 异步命令SaveRecipeCommandnewDelegateCommand(async()awaitExecuteSaveRecipeAsync());// 或带CanExecute// SaveRecipeCommand new DelegateCommand(ExecuteSaveRecipeAsync, CanSaveRecipe)// .ObservesProperty(() IsDirty);}// 异步执行方法privateasyncTaskExecuteSaveRecipeAsync(){try{IsBusytrue;// 显示加载动画await_plcService.WriteRecipeAsync(CurrentRecipe);// 异步下发PLCawaitTask.Delay(500);// 模拟等待MachineStatus配方保存成功;}catch(Exceptionex){// 日志 弹窗提示_dialogService.Show(保存失败,ex.Message);}finally{IsBusyfalse;}}注意默认异步命令不允许并行执行防止重复点击。需要并行时可调用.EnableParallelExecution()Prism较新版本支持。5. 工业级高级用法与最佳实践权限控制publicDelegateCommandEmergencyStopCommand{get;}// CanExecute 中加入用户角色判断privateboolCanEmergencyStop()CurrentUser?.HasPermission(EmergencyStop)true;全局复合命令CompositeCommand用于“全局急停”多个模块的子命令同时执行。CompositeCommand聚合多个DelegateCommand任一子命令不可执行则整体不可执行。与绑定通知结合CanExecute依赖的属性必须使用SetProperty更新。结合IValueConverter实现按钮颜色/文字随状态变化。与EventAggregator结合执行命令后发布事件让其他模块报警、趋势响应。最佳实践命令初始化放在ViewModel构造函数中。Execute方法保持简洁复杂逻辑委托给注入的服务IPlcService、IRecipeService。避免在CanExecute中做耗时操作应预计算状态。长时间运行的上位机注意在模块卸载时释放命令相关资源。测试ViewModel单元测试中可直接调用command.Execute()和command.CanExecute()。6. 完整工业示例设备控制面板publicclassDevicePanelViewModel:BindableBase{privatebool_isPlcConnected;publicboolIsPlcConnected{get_isPlcConnected;setSetProperty(ref_isPlcConnected,value);}publicDelegateCommandStartCommand{get;privateset;}publicDevicePanelViewModel(IPlcServiceplcService){StartCommandnewDelegateCommand(async()awaitplcService.StartDeviceAsync(),CanStart).ObservesProperty(()IsPlcConnected).ObservesProperty(()HasFault);}privateboolCanStart()IsPlcConnected!HasFault;}对应XAML中按钮会根据PLC连接状态和故障状态自动灰显/亮显。掌握DelegateCommand后你的工业上位机交互就具备了真正的MVVM纯净性UI只负责展示和触发命令所有业务逻辑和状态判断都在ViewModel中。立即实践建议在你的MachineMonitorViewModel中添加StartMachineCommand和StopMachineCommand。使用ObservesProperty让按钮根据IsRunning、HasFault等属性自动启用/禁用。实现一个异步SaveParameterCommand模拟向PLC写入参数。运行测试改变PLC模拟状态观察按钮是否实时变化。完成后界面操作将非常流畅、专业像真正的工厂HMI一样可靠。下一节我们将进入Prism弹窗对象IDialogService详解学习如何优雅地弹出参数设置、报警确认、配方编辑等工业常用弹窗并实现主窗口与弹窗之间的参数传递和返回值处理。有任何命令不刷新、异步异常、CanExecute不生效等问题随时贴出代码我会帮你排查优化。Prism ObservesProperty 高级用法详解工业级上位机专篇ObservesProperty是Prism DelegateCommand最强大、最实用的特性之一。它让命令的CanExecute按钮是否可用能够自动响应ViewModel中属性的变化无需手动调用RaiseCanExecuteChanged()极大简化了工业上位机中“状态联动”场景的代码。在工厂监控系统中这意味着“启动设备”按钮只有在PLC已连接 无故障 参数已校验时才亮起。报警确认按钮根据报警等级动态启用。保存配方按钮在“有修改IsDirty”时才可用。所有状态实时联动操作员体验接近原生HMI。1. 基础回顾与正确写法publicclassMachineControlViewModel:BindableBase{privatebool_isPlcConnected;publicboolIsPlcConnected{get_isPlcConnected;setSetProperty(ref_isPlcConnected,value);}privatebool_hasFault;publicboolHasFault{get_hasFault;setSetProperty(ref_hasFault,value);}publicDelegateCommandStartMachineCommand{get;privateset;}publicMachineControlViewModel(){StartMachineCommandnewDelegateCommand(ExecuteStart,CanExecuteStart).ObservesProperty(()IsPlcConnected)// 关键链式调用.ObservesProperty(()HasFault);}privatevoidExecuteStart(){/* PLC启动指令 */}privateboolCanExecuteStart(){returnIsPlcConnected!HasFault;}}XAML中按钮会自动根据状态灰显/亮显无需额外代码。链式调用可以连续.ObservesProperty()观察多个属性。2. 高级用法一嵌套属性Nested Properties——最常用工业技巧Prism 支持观察属性链只要链上每个对象都实现INotifyPropertyChanged。工业场景示例观察子对象PLC状态对象、当前报警对象的属性。// ViewModel 中privatePlcStatus_plcStatusnewPlcStatus();publicPlcStatusPlcStatus{get_plcStatus;setSetProperty(ref_plcStatus,value);}privateAlarmItem_currentAlarm;publicAlarmItemCurrentAlarm{get_currentAlarm;setSetProperty(ref_currentAlarm,value);}// PlcStatus 类也要继承 BindableBase 或实现 INPCpublicclassPlcStatus:BindableBase{privatebool_isConnected;publicboolIsConnected{get_isConnected;setSetProperty(ref_isConnected,value);}privatestring_errorCode;publicstringErrorCode{get_errorCode;setSetProperty(ref_errorCode,value);}}命令观察嵌套属性StartMachineCommandnewDelegateCommand(ExecuteStart,CanExecuteStart).ObservesProperty(()PlcStatus.IsConnected)// 嵌套1.ObservesProperty(()PlcStatus.ErrorCode)// 嵌套2.ObservesProperty(()CurrentAlarm.Severity);// 嵌套3机制说明Prism 会监听整个属性链上的PropertyChanged事件。只要链上任意一层属性变化IsConnected、ErrorCode、Severity都会触发RaiseCanExecuteChanged()。这对模块化上位机特别友好PLC数据服务更新子对象属性时命令状态自动刷新。注意如果中间对象如PlcStatus整个被替换SetProperty也需要观察父属性() PlcStatus才能完整捕获。3. 高级用法二ObservesCanExecutePrism 8 推荐简化写法当CanExecute方法逻辑简单直接返回某个属性或表达式时可省略单独的CanExecute方法。// 方式一传统 ObservesPropertypublicDelegateCommandSaveCommand{get;}// 方式二使用 ObservesCanExecute更简洁publicMachineControlViewModel(){SaveCommandnewDelegateCommand(ExecuteSave).ObservesCanExecute(()IsDirtyIsPlcConnected);// 直接传入表达式}优点无需单独写bool CanExecuteSave()方法。表达式支持逻辑运算、||、!等。内部仍会自动处理属性变化监听。适用场景简单状态判断复杂逻辑仍推荐单独CanExecute方法 ObservesProperty可读性更好便于调试。4. 高级用法三集合相关观察ObservesCollection workaroundPrism 原生没有ObservesCollection但工业上位机常需根据列表状态控制命令例如选中项数量 0 时才能“批量删除”。推荐解决方案privateObservableCollectionRecipeItem_recipesnew();publicObservableCollectionRecipeItemRecipes{get_recipes;}publicDelegateCommandDeleteSelectedCommand{get;privateset;}publicMachineControlViewModel(){DeleteSelectedCommandnewDelegateCommand(ExecuteDelete,CanDelete);// 手动订阅集合变化Recipes.CollectionChanged(s,e)DeleteSelectedCommand.RaiseCanExecuteChanged();// 同时观察选中项属性DeleteSelectedCommand.ObservesProperty(()SelectedRecipe);}privateboolCanDelete()SelectedRecipe!null||Recipes.Count0;进阶可封装一个扩展方法或基类ViewModel自动为ObservableCollection属性添加监听。5. 高级用法四与复合命令CompositeCommand结合全局急停命令可聚合多个模块的子命令并观察全局状态publicCompositeCommandGlobalEmergencyStopCommand{get;}newCompositeCommand();publicMachineControlViewModel(){varlocalStopnewDelegateCommand(ExecuteLocalStop,CanLocalStop).ObservesProperty(()IsPlcConnected);GlobalEmergencyStopCommand.RegisterCommand(localStop);}6. 工业级最佳实践与注意事项性能只观察真正影响CanExecute的属性避免观察过多无关属性。线程安全属性变化必须在UI线程通过IDispatcher或 Prism 的绑定机制。嵌套深度支持较深链但建议保持在 2-3 层避免调试困难。模块化场景在不同模块的 ViewModel 中使用ObservesProperty结合EventAggregator实现跨模块状态联动。测试单元测试中可直接调用command.CanExecute(null)和command.RaiseCanExecuteChanged()验证。与 IValueConverter 结合按钮文字/颜色可通过 Converter 进一步美化例如“启动”/“停止”切换。替代方案当观察非常复杂时可在属性 Setter 中手动调用RaiseCanExecuteChanged()作为补充。Prism 版本Prism 8 行为更稳定推荐使用最新版。7. 完整工业示例产线控制面板publicclassLineControlViewModel:BindableBase{publicPlcStatusPlcStatus{get;}newPlcStatus();publicObservableCollectionAlarmItemActiveAlarms{get;}new();publicDelegateCommandStartLineCommand{get;privateset;}publicDelegateCommandAcknowledgeAllAlarmsCommand{get;privateset;}publicLineControlViewModel(){StartLineCommandnewDelegateCommand(ExecuteStartLine,CanStartLine).ObservesProperty(()PlcStatus.IsConnected).ObservesProperty(()PlcStatus.ErrorCode).ObservesProperty(()ActiveAlarms.Count);// 集合Count间接观察需手动辅助AcknowledgeAllAlarmsCommandnewDelegateCommand(ExecuteAckAll).ObservesCanExecute(()ActiveAlarms.Count0);}privateboolCanStartLine()PlcStatus.IsConnectedPlcStatus.ErrorCode0ActiveAlarms.Count0;}掌握ObservesProperty高级用法后你的命令系统将具备真正的“响应式”能力状态一变按钮立即响应极大提升上位机的专业度和可靠性。立即实践建议在现有 ViewModel 中为一个命令添加 2-3 个ObservesProperty包含嵌套属性。用ObservesCanExecute重构一个简单 CanExecute 方法。测试 PLC 模拟数据变化观察按钮状态是否实时更新。尝试为ObservableCollection添加手动监听。下一节我们将进入Prism弹窗对象IDialogService详解学习如何用弹窗实现参数设置、报警确认、配方编辑等工业常用交互并结合命令实现完整流程。如果你在实际使用中遇到ObservesProperty不触发、嵌套属性无效、集合不响应等问题请贴出你的 ViewModel 代码我会帮你精准排查和优化。现在就动手把你的“启动”按钮用嵌套属性观察起来吧让它真正随PLC状态实时联动。准备好了告诉我我们继续前进现在就动手把你的设备启停按钮用DelegateCommand实现起来吧感受Prism命令带来的清晰架构。准备好了告诉我我们继续下一部分