当前位置：首页 > news >正文

Prism弹窗对象_弹窗向主窗口返回值详解（工业级上位机专篇）

news 2026/4/24 20:06:30

Prism弹窗对象_弹窗向主窗口返回值详解（工业级上位机专篇）

在工业上位机开发中，弹窗不仅仅是显示信息，更需要双向数据交互：
主窗口 → 弹窗传递参数（例如当前配方、报警对象）
弹窗 → 主窗口返回处理结果（修改后的配方、用户确认结果、编辑后的参数等）

本节重点讲解Prism 中弹窗向主窗口返回值的完整实现方式，这是配方编辑、参数设置、报警确认等工业场景的核心交互。

1. 核心机制回顾

Prism 使用IDialogResult来传递返回值，主要包含两部分：

ButtonResult：用户点击了什么按钮（OK / Cancel / Yes / No 等）
Parameters：DialogParameters对象，可携带任意自定义数据返回

返回值传递有两种常用方式：

方式一：通过回调函数（最常用、最灵活）
方式二：通过RequestClose事件（弹窗内部主动关闭时返回）

2. 完整实战示例 —— 配方编辑弹窗返回值

步骤1：弹窗 ViewModel（返回数据）

// Views/Dialogs/RecipeEditDialogViewModel.csusingPrism.Mvvm;usingPrism.Services.Dialogs;usingPrism.Commands;publicclassRecipeEditDialogViewModel:BindableBase,IDialogAware{privatereadonlyIPlcService_plcService;publicstringTitle=>"配方编辑";privateRecipe_currentRecipe;publicRecipeCurrentRecipe{get=>_currentRecipe;set=>SetProperty(ref_currentRecipe,value);}publicDelegateCommandSaveCommand{get;privateset;}publicDelegateCommandCancelCommand{get;privateset;}publicRecipeEditDialogViewModel(IPlcServiceplcService){_plcService=plcService;SaveCommand=newDelegateCommand(async()=>awaitExecuteSaveAsync());CancelCommand=newDelegateCommand(()=>CloseDialog(ButtonResult.Cancel));}publicvoidOnDialogOpened(IDialogParametersparameters){// 接收主窗口传入的参数CurrentRecipe=parameters.GetValue<Recipe>("Recipe")??newRecipe();}privateasyncTaskExecuteSaveAsync(){try{IsBusy=true;await_plcService.WriteRecipeAsync(CurrentRecipe);// ==================== 关键：向主窗口返回值 ====================varreturnParameters=newDialogParameters{{"SavedRecipe",CurrentRecipe},// 返回修改后的完整配方{"Success",true},{"Message","配方保存成功"},{"Timestamp",DateTime.Now}};RequestClose?.Invoke(newDialogResult(ButtonResult.OK,returnParameters));}catch(Exceptionex){varerrorParams=newDialogParameters{{"Success",false},{"Message",$"保存失败：{ex.Message}"}};RequestClose?.Invoke(newDialogResult(ButtonResult.Cancel,errorParams));}finally{IsBusy=false;}}privatevoidCloseDialog(ButtonResultresult){RequestClose?.Invoke(newDialogResult(result));}publicboolCanCloseDialog()=>!IsBusy;publicvoidOnDialogClosed(){}publiceventAction<IDialogResult>RequestClose;}

步骤2：主窗口 ViewModel 中接收返回值

// ShellViewModel 或 MainViewModelpublicclassMainViewModel:BindableBase{privatereadonlyIDialogService_dialogService;publicMainViewModel(IDialogServicedialogService){_dialogService=dialogService;}publicDelegateCommandEditRecipeCommand{get;privateset;}publicMainViewModel(){EditRecipeCommand=newDelegateCommand(async()=>awaitEditRecipeAsync());}privateasyncTaskEditRecipeAsync(){varparameters=newDialogParameters{{"Recipe",CurrentRecipe}// 传入当前配方};// ==================== 接收弹窗返回值 ====================_dialogService.ShowDialog("RecipeEditDialog",parameters,result=>{if(result.Result==ButtonResult.OK){// 成功返回varsavedRecipe=result.Parameters.GetValue<Recipe>("SavedRecipe");varmessage=result.Parameters.GetValue<string>("Message");// 处理返回值CurrentRecipe=savedRecipe;// 更新主界面数据RefreshUIAfterSave();// 刷新趋势、报警等ShowSuccessMessage(message);}elseif(result.Result==ButtonResult.Cancel){// 用户取消或失败varsuccess=result.Parameters.GetValue<bool>("Success");if(!success){varerrorMsg=result.Parameters.GetValue<string>("Message");ShowErrorMessage(errorMsg??"操作已取消");}}});}}

3. 推荐的返回值设计规范（工业级）

建议在返回的DialogParameters中统一包含以下字段：

"Success"：bool 类型，表示操作是否成功
"SavedRecipe"/"NewValue"/"ConfirmedAlarm"：具体业务数据
"Message"：友好提示信息
"ErrorCode"：可选，错误码（便于后续处理）
"Timestamp"：操作时间戳

这样主界面处理逻辑更加清晰统一。

4. 异步等待返回值（现代写法推荐）

如果使用 Prism 较新版本或自定义扩展方法，可以用await方式：

// 扩展方法（推荐封装）publicstaticTask<IDialogResult>ShowDialogAsync(thisIDialogServiceservice,stringname,IDialogParametersparameters){vartcs=newTaskCompletionSource<IDialogResult>();service.ShowDialog(name,parameters,result=>tcs.TrySetResult(result));returntcs.Task;}// 使用方式varresult=await_dialogService.ShowDialogAsync("RecipeEditDialog",parameters);if(result.Result==ButtonResult.OK){varsaved=result.Parameters.GetValue<Recipe>("SavedRecipe");awaitProcessSavedRecipeAsync(saved);}