Prism Region

6 阅读2分钟

1.Region 是什么

Region 就是界面上的一个"占位坑":Shell(主窗口)只负责划分区域,具体放哪个 View 由各模块在运行时决定。这样 Shell 和 View 之间互不引用,实现解耦。

2.定义 Region

在 Shell 的 XAML 里给容器控件起一个区域名:

xml
<Window xmlns:prism="http://prismlibrary.com/">
    <DockPanel>
        <ItemsControl DockPanel.Dock="Left" prism:RegionManager.RegionName="MenuRegion" />
        <ContentControl prism:RegionManager.RegionName="ContentRegion" />
    </DockPanel>
</Window>

Prism 默认支持三类控件:

控件行为
ContentControl同一时间只显示一个 View
ItemsControl同时显示多个 View
Selector(TabControl、ListBox 等)多个 View,其中一个被选中

其他控件(如 StackPanel)需要自己写 RegionAdapter。

3.往 Region 里放 View 的三种方式

方式一:View Discovery(自动发现),适合固定不变的内容,如菜单、状态栏。Region 一创建,View 就自动放进去:这种方式不需要注册,可在app.xmal 中固定。

csharp
regionManager.RegisterViewWithRegion("MenuRegion", typeof(MenuView));

方式二:View Injection(手动注入),适合需要自己精确控制添加、移除的场景:

csharp
var region = regionManager.Regions["ContentRegion"];
var view = container.Resolve<ViewA>();
region.Add(view);
region.Activate(view);    // 显示
region.Deactivate(view);  // 隐藏
region.Remove(view);      // 移除

方式三:Navigation(导航),最常用,适合页面切换。先注册,再按名字导航:

csharp
// App.xaml.cs 或 Module 的 RegisterTypes 中
containerRegistry.RegisterForNavigation<ViewA>();
containerRegistry.RegisterForNavigation<ViewB, ViewBViewModel>();

// ViewModel 中(构造函数注入 IRegionManager)
_regionManager.RequestNavigate("ContentRegion", "ViewA");
  1. 导航传参与生命周期

传参:

csharp
var p = new NavigationParameters { { "id", 42 } };
_regionManager.RequestNavigate("ContentRegion", "ViewB", p);

目标 ViewModel 实现 INavigationAware 来接收参数:

csharp
public class ViewBViewModel : BindableBase, INavigationAware
{
    // 导航进来时调用,在这里取参数
    public void OnNavigatedTo(NavigationContext context)
    {
        var id = context.Parameters.GetValue<int>("id");
    }

    // true = 复用已有实例;false = 新建一个实例
    public bool IsNavigationTarget(NavigationContext context) => true;

    // 离开时调用,可在这里保存状态
    public void OnNavigatedFrom(NavigationContext context) { }
}

其他几个常用接口:

  1. IConfirmNavigationRequest:离开前拦截,比如弹出"有未保存的修改,确定离开吗?"

  2. IRegionMemberLifetime:KeepAlive 返回 false 时,View 离开后会被销毁,不留在 Region 里。

  3. IRegionNavigationJournal:导航历史。在 OnNavigatedTo 里保存 context.NavigationService.Journal,之后调用 GoBack() / GoForward() 实现前进后退。

  4. 新手常见的坑 导航没反应也不报错:通常是 View 名字写错或没注册。RequestNavigate 不会抛异常,要用回调检查结果:

csharp
   _regionManager.RequestNavigate("ContentRegion", "ViewA", result =>
   {
       // 在这里打断点,查看 result 里的错误信息
   });

启动时导航失败:在 Shell 构造函数里导航时 Region 还没创建。默认页用 RegisterViewWithRegion,或者放到 OnInitialized / 模块的 OnInitialized 里再导航。 命名空间因版本而异:Prism 8 及以前是 Prism.Regions,Prism 9 改成了 Prism.Navigation.Regions。照着旧教程写编译不过时,先检查这里。 Region 名用常量:建一个 RegionNames 静态类统一管理,避免字符串拼写错误。