WPF MVVM框架 - Prism IRegionManager 视图注入和导航

在 WPF Prism 框架中，IRegionManager 是一个核心服务，用于管理应用程序的 UI 区域（Regions），实现模块化、松耦合的视图注入和导航。它的主要功能是允许开发者动态地将视图（Views）注入到指定的 UI 区域，并支持复杂的导航逻辑。

区域（Region）的概念

Region 是 UI 中的一个占位符（如 ContentControl、ItemsControl 或 TabControl），通过 Prism 的附加属性（RegionName）标记。

例如，在 XAML 中定义一个区域：

<ContentControl prism:RegionManager.RegionName="MainRegion" />

主要功能

视图注册与注入

将视图动态注入到指定区域，无需直接操作 UI 控件

// 注册视图到区域（通常在模块初始化时）
_regionManager.RegisterViewWithRegion("MainRegion", typeof(MyView));

或在 ViewModel 中动态添加视图

var view = _container.Resolve<MyView>();
_regionManager.Regions["MainRegion"].Add(view);

导航

支持导航到指定区域的视图，并传递参数。

_regionManager.RequestNavigate("MainRegion", "ViewA", parameters =>
{
    if (parameters.Result == NavigationResult.Success)
    {
        // 导航成功后的逻辑
    }
});

导航目标视图需实现 INavigationAware 接口以处理导航生命周期事件（如 OnNavigatedTo）

多视图管理

一个区域可以同时显示多个视图（如 ItemsControl 区域），通过 Add 或 Activate 方法控制视图的显示。

_regionManager.Regions["TabRegion"].Add(view1, "View1");
_regionManager.Regions["TabRegion"].Add(view2, "View2");
_regionManager.Regions["TabRegion"].Activate(view1); // 激活特定视图

区域作用域（Scoped Regions）

支持嵌套区域和作用域管理（如父子视图中的区域隔离）。

示例：在子视图中创建局部区域管理器：

var scopedRegionManager = _regionManager.CreateRegionManager();
RegionManager.SetRegionManager(childElement, scopedRegionManager);

导航日志（Journal）

支持导航历史记录（前进/后退），通过 INavigateAsync 接口管理。

_regionManager.Regions["MainRegion"].NavigationService.Journal.GoBack();

关键接口与方法

典型使用场景

模块化加载视图：不同模块通过 IRegionManager 将视图注入到共享区域（如主窗口的侧边栏、内容区域）。

动态切换界面：根据用户操作导航到不同视图（如菜单点击切换主内容）。

复合界面：在同一个区域中堆叠多个视图（如仪表盘显示多个控件）。

参数传递：在导航时传递上下文数据（如选中项的 ID）：

var parameters = new NavigationParameters();
parameters.Add("id", 123);
_regionManager.RequestNavigate("MainRegion", "DetailView", parameters);

完整导航流程示例

public class MyViewModel
{
    private readonly IRegionManager _regionManager;

    public MyViewModel(IRegionManager regionManager)
    {
        _regionManager = regionManager;
    }

    public void NavigateToViewA()
    {
        var parameters = new NavigationParameters();
        parameters.Add("message", "Hello from ViewA");
        _regionManager.RequestNavigate("MainRegion", "ViewA", parameters);
    }
}

// ViewA 需要实现 INavigationAware 以接收参数
public class ViewA : UserControl, INavigationAware
{
    public void OnNavigatedTo(NavigationContext navigationContext)
    {
        var message = navigationContext.Parameters["message"] as string;
        // 处理参数
    }

    public bool IsNavigationTarget(NavigationContext navigationContext) => true;
    public void OnNavigatedFrom(NavigationContext navigationContext) { }
}

注意事项

区域名称一致性：确保 XAML 中定义的 RegionName 与代码中使用的名称一致。

依赖注入：IRegionManager 通常通过构造函数注入到 ViewModel 或模块中。

生命周期管理：视图需实现 IRegionMemberLifetime 或 INavigationAware 控制实例的生命周期（如单例或每次导航新建）