WPF MVVM开发中Stylet的IWindowManager应用解析

1. WPF/Stylet中的IWindowManager核心价值解析

在WPF MVVM开发中，窗口管理一直是个痛点。传统方式需要ViewModel直接操作View，这严重违反了MVVM的分离原则。我在多个工业控制项目中深刻体会到，当需要弹出等待窗口、确认对话框或自定义消息框时，Stylet的IWindowManager接口提供了优雅的解决方案。

与Prism等框架的对话框服务相比，Stylet的窗口管理器有三大不可替代的优势：

1. 完全基于约定优于配置的原则，无需复杂初始化
2. 原生支持异步/等待模式
3. 与Stylet的ViewModel生命周期完美集成

特别是在上位机软件开发中，当需要处理长时间运行的PLC通信或视觉检测任务时，一个可取消的等待窗口能极大改善用户体验。通过IWindowManager.ShowDialog()方法，我们可以实现：

• 模态阻塞式对话框（如确认删除操作）
• 进度展示窗口（带取消按钮）
• 自适应内容的消息提示框

2. 环境配置与基础使用

2.1 基础项目搭建

首先通过NuGet安装Stylet核心包：

Install-Package Stylet

在App.xaml中启用Stylet的Bootstrapper：

<Application.Resources> <ResourceDictionary> <s:Bootstrapper x:Key="bootstrapper"> <s:Bootstrapper.BootstrapperType> <x:Type TypeName="YourNamespace.Bootstrapper, YourAssembly"/> </s:Bootstrapper.BootstrapperType> </s:Bootstrapper> </ResourceDictionary> </ApplicationResources>

创建继承Stylet.Bootstrapper的启动类：

public class Bootstrapper : Bootstrapper<ShellViewModel> { protected override void ConfigureIoC(IStyletIoCBuilder builder) { builder.Bind<IWindowManager>().To<WindowManager>().InSingletonScope(); } }

2.2 基础对话框调用

在ViewModel中注入并使用窗口管理器：

public class MainViewModel { private readonly IWindowManager _windowManager; public MainViewModel(IWindowManager windowManager) { _windowManager = windowManager; } public void ShowAlert() { _windowManager.ShowMessageBox( "这是一条重要提示", "操作确认", MessageBoxButton.OK, MessageBoxImage.Information); } }

3. 高级窗口管理实战

3.1 自定义等待窗口实现

创建等待窗口ViewModel：

public class ProgressDialogViewModel : Screen { private string _message; public string Message { get => _message; set => SetAndNotify(ref _message, value); } private bool _canCancel; public bool CanCancel { get => _canCancel; set => SetAndNotify(ref _canCancel, value); } private bool _isCancelled; public bool IsCancelled { get => _isCancelled; private set => SetAndNotify(ref _isCancelled, value); } public void Cancel() { IsCancelled = true; RequestClose(true); } }

配套的ProgressDialogView.xaml：

<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" WindowStartupLocation="CenterOwner" ResizeMode="NoResize" SizeToContent="WidthAndHeight"> <StackPanel Margin="20"> <ProgressBar IsIndeterminate="True" Height="20" Width="200"/> <TextBlock Text="{Binding Message}" Margin="0,10,0,0"/> <Button Content="取消" Command="{s:Action Cancel}" Visibility="{Binding CanCancel, Converter={x:Static s:BoolToVisibilityConverter.Instance}}" Margin="0,10,0,0" Width="80" HorizontalAlignment="Center"/> </StackPanel> </Window>

使用示例：

public async Task LongRunningOperation() { var vm = new ProgressDialogViewModel { Message = "正在处理数据...", CanCancel = true }; _windowManager.ShowDialog(vm); try { await Task.Run(() => { // 模拟耗时操作 for (int i = 0; i < 100; i++) { if (vm.IsCancelled) break; Thread.Sleep(100); } }); } finally { if (vm.IsActive) { await _windowManager.TryCloseAsync(vm); } } }

3.2 动态内容对话框

创建支持动态内容的对话框：

public class DynamicDialogViewModel : Screen { public object DialogContent { get; } public string Title { get; } public DynamicDialogViewModel(object content, string title) { DialogContent = content; Title = title; } }

对应的DynamicDialogView.xaml使用ContentControl：

<Window xmlns:s="https://github.com/canton7/Stylet" Title="{Binding Title}"> <ContentControl s:View.Model="{Binding DialogContent}"/> </Window>

使用方式：

var contentVm = new UserInputViewModel(); var dialogVm = new DynamicDialogViewModel(contentVm, "请输入参数"); var result = _windowManager.ShowDialog(dialogVm); if (result == true) { // 处理用户输入 }

4. 工业级应用技巧

4.1 线程安全调用模式

在异步操作中安全更新UI：

public class SafeProgressViewModel : Screen { private readonly IWindowManager _windowManager; public SafeProgressViewModel(IWindowManager windowManager) { _windowManager = windowManager; } public async Task ProcessDataAsync() { var progressVm = new ProgressDialogViewModel(); // 必须在UI线程显示对话框 await Execute.OnUIThreadAsync(() => _windowManager.ShowDialog(progressVm)); try { await Task.Run(() => { // 后台线程工作 for (int i = 0; i <= 100; i++) { // 通过Execute.OnUIThread安全更新 Execute.OnUIThread(() => { progressVm.Message = $"已完成 {i}%"; }); Thread.Sleep(50); } }); } finally { await Execute.OnUIThreadAsync(() => _windowManager.TryCloseAsync(progressVm)); } } }

4.2 对话框结果处理模式

增强型结果处理方案：

public enum CustomDialogResult { Ok, Cancel, Retry, Ignore } public class CustomDialogViewModel : Screen { public CustomDialogResult Result { get; private set; } public void SetResult(CustomDialogResult result) { Result = result; RequestClose(true); } } // 使用示例 var vm = new CustomDialogViewModel(); _windowManager.ShowDialog(vm); switch (vm.Result) { case CustomDialogResult.Ok: // 处理确定操作 break; case CustomDialogResult.Retry: // 处理重试逻辑 break; // 其他情况处理 }

5. 性能优化与异常处理

5.1 窗口复用策略

实现窗口池管理：

public class DialogPool : IDisposable { private readonly ConcurrentDictionary<Type, Stack<Screen>> _pool = new(); private readonly IWindowManager _windowManager; public DialogPool(IWindowManager windowManager) { _windowManager = windowManager; } public T GetViewModel<T>() where T : Screen, new() { var type = typeof(T); if (_pool.TryGetValue(type, out var stack) && stack.TryPop(out var vm)) { return (T)vm; } return new T(); } public void ReturnViewModel(Screen viewModel) { var type = viewModel.GetType(); var stack = _pool.GetOrAdd(type, _ => new Stack<Screen>()); stack.Push(viewModel); } public void Dispose() { foreach (var stack in _pool.Values) { while (stack.TryPop(out var vm)) { (vm as IDisposable)?.Dispose(); } } _pool.Clear(); } }

5.2 健壮性增强实践

异常处理包装器：

public static class WindowManagerExtensions { public static async Task<bool> ShowDialogWithRetry( this IWindowManager windowManager, Screen viewModel, int maxRetries = 3) { int attempts = 0; while (attempts < maxRetries) { try { return await windowManager.ShowDialogAsync(viewModel) == true; } catch (Exception ex) when (attempts < maxRetries - 1) { attempts++; await Task.Delay(100 * attempts); // 可添加日志记录 } } return false; } }

6. 实际项目集成案例

6.1 机器视觉检测流程

典型视觉检测对话框流程：

public async Task RunInspectionAsync() { var progressVm = new ProgressDialogViewModel { Message = "正在初始化相机...", CanCancel = true }; var showTask = Execute.OnUIThreadAsync(() => _windowManager.ShowDialog(progressVm)); try { // 初始化硬件 await InitializeCameraAsync(progressVm); progressVm.Message = "正在采集图像..."; var image = await CaptureImageAsync(); progressVm.Message = "正在处理图像..."; var result = await ProcessImageAsync(image); progressVm.Message = "生成检测报告..."; await GenerateReportAsync(result); await Execute.OnUIThreadAsync(() => _windowManager.ShowMessageBox("检测完成", "结果", MessageBoxButton.OK, MessageBoxImage.Information)); } catch (OperationCanceledException) { await Execute.OnUIThreadAsync(() => _windowManager.ShowMessageBox("操作已取消", "提示", MessageBoxButton.OK, MessageBoxImage.Warning)); } catch (Exception ex) { await Execute.OnUIThreadAsync(() => _windowManager.ShowMessageBox($"检测失败: {ex.Message}", "错误", MessageBoxButton.OK, MessageBoxImage.Error)); } finally { if (progressVm.IsActive) { await Execute.OnUIThreadAsync(() => _windowManager.TryCloseAsync(progressVm)); } } }

6.2 数据库操作确认流程

带数据绑定的确认对话框：

public class DeleteConfirmationViewModel : Screen { public string ItemName { get; } public bool BackupBeforeDelete { get; set; } public DeleteConfirmationViewModel(string itemName) { ItemName = itemName; } } // 使用示例 public async Task DeleteItemAsync(DataItem item) { var vm = new DeleteConfirmationViewModel(item.Name); if (await _windowManager.ShowDialogAsync(vm) == true) { try { if (vm.BackupBeforeDelete) { await BackupItemAsync(item); } await _dataService.DeleteAsync(item.Id); } catch (Exception ex) { _windowManager.ShowMessageBox($"删除失败: {ex.Message}", "错误"); } } }

7. 样式定制与主题集成

7.1 自定义对话框样式

创建统一样式资源：

<Style TargetType="Window" x:Key="DialogWindowStyle"> <Setter Property="WindowStyle" Value="None"/> <Setter Property="AllowsTransparency" Value="True"/> <Setter Property="Background" Value="Transparent"/> <Setter Property="WindowStartupLocation" Value="CenterOwner"/> <Setter Property="SizeToContent" Value="WidthAndHeight"/> <Setter Property="Template"> <Setter.Value> <ControlTemplate TargetType="Window"> <Border Background="#CC000000" Padding="50"> <Border Background="{DynamicResource WindowBackgroundBrush}" CornerRadius="5" BorderThickness="1" BorderBrush="{DynamicResource BorderBrush}"> <Grid> <Grid.RowDefinitions> <RowDefinition Height="Auto"/> <RowDefinition Height="*"/> <RowDefinition Height="Auto"/> </Grid.RowDefinitions> <TextBlock Text="{TemplateBinding Title}" Style="{StaticResource DialogTitleStyle}"/> <ContentPresenter Grid.Row="1"/> <StackPanel Grid.Row="2" Orientation="Horizontal" HorizontalAlignment="Right"> <Button Content="确定" Command="{s:Action Accept}" Style="{StaticResource DialogButtonStyle}"/> <Button Content="取消" Command="{s:Action Cancel}" Style="{StaticResource DialogButtonStyle}"/> </StackPanel> </Grid> </Border> </Border> </ControlTemplate> </Setter.Value> </Setter> </Style>

应用到ViewModel：

public class StyledDialogViewModel : Screen { public override void OnViewLoaded() { if (View is Window window) { window.Style = Application.Current.FindResource("DialogWindowStyle") as Style; } } }

7.2 动态主题切换

响应系统主题变化：

public class ThemeAwareDialogViewModel : Screen { private readonly IEventAggregator _eventAggregator; public ThemeAwareDialogViewModel(IEventAggregator eventAggregator) { _eventAggregator = eventAggregator; _eventAggregator.Subscribe(this); } public void Handle(ThemeChangedEvent message) { if (View is Window window) { window.Background = new SolidColorBrush(message.NewTheme.BackgroundColor); } } protected override void OnClose() { _eventAggregator.Unsubscribe(this); base.OnClose(); } }

8. 测试与调试技巧

8.1 单元测试策略

使用Moq测试窗口交互：

[Test] public void Should_ShowConfirmation_When_DeletingItem() { // Arrange var windowManagerMock = new Mock<IWindowManager>(); windowManagerMock.Setup(x => x.ShowMessageBox(It.IsAny<string>(), It.IsAny<string>())) .Returns(true); var vm = new MainViewModel(windowManagerMock.Object); // Act vm.DeleteCommand.Execute(null); // Assert windowManagerMock.Verify(x => x.ShowMessageBox( "确定要删除此项吗?", "确认删除", MessageBoxButton.YesNo, MessageBoxImage.Question), Times.Once); }

8.2 诊断窗口泄漏

窗口生命周期监控：

public class WindowTracker { private static readonly List<WeakReference<Window>> _windows = new(); public static void Track(Window window) { window.Closed += (s, e) => { lock (_windows) { _windows.RemoveAll(w => w.TryGetTarget(out var target) && target == window); } }; lock (_windows) { _windows.Add(new WeakReference<Window>(window)); } } public static int GetActiveWindowCount() { lock (_windows) { _windows.RemoveAll(w => !w.TryGetTarget(out _)); return _windows.Count; } } } // 在窗口构造函数中调用 public partial class CustomDialog : Window { public CustomDialog() { InitializeComponent(); WindowTracker.Track(this); } }

9. 性能对比与选型建议

9.1 与其它方案对比

9.2 选型决策树

1. 是否需要深度MVVM支持？

   • 是 → 选择Stylet或Prism
     • 是否需要高级异步功能？ → Stylet
     • 是否需要成熟生态系统？ → Prism
   • 否 → 考虑HandyControl等UI库

2. 项目是否已使用Stylet？

   • 是 → 优先使用IWindowManager
   • 否 → 评估引入成本

3. 是否需要高度定制化的对话框？

   • 是 → Stylet+自定义Window
   • 否 → 使用内置解决方案

10. 扩展与进阶方向

10.1 多语言支持实现

创建本地化服务：

public interface ILocalizationService { string Translate(string key); } public class LocalizedDialogViewModel : Screen { private readonly ILocalizationService _localization; public string Title => _localization.Translate("DeleteConfirmationTitle"); public string Message => string.Format( _localization.Translate("DeleteConfirmationMessage"), ItemName); public string ItemName { get; } public LocalizedDialogViewModel(ILocalizationService localization, string itemName) { _localization = localization; ItemName = itemName; } }

10.2 动态窗口布局

根据内容调整布局：

public class AdaptiveDialogViewModel : Screen { public ObservableCollection<DialogSection> Sections { get; } = new(); public AdaptiveDialogViewModel() { Sections.Add(new TextSection { Content = "基础信息" }); Sections.Add(new InputSection { FieldName = "用户名" }); // 可根据条件动态添加不同部分 } } public abstract class DialogSection : PropertyChangedBase { public abstract FrameworkElement CreateView(); } public class InputSection : DialogSection { private string _fieldName; public string FieldName { get => _fieldName; set => SetAndNotify(ref _fieldName, value); } public override FrameworkElement CreateView() { return new StackPanel { Orientation = Orientation.Horizontal, Children = { new TextBlock { Text = FieldName, Width = 100 }, new TextBox { Width = 200 } } }; } }

在多年的WPF开发实践中，我发现窗口管理是最容易被低估的模块。良好的对话框交互能显著提升用户体验，而混乱的窗口管理则会导致维护噩梦。Stylet的IWindowManager在简洁性和功能性之间取得了完美平衡，特别是在处理复杂业务流程时，其清晰的API设计和强大的异步支持让开发者能专注于业务逻辑而非UI细节。