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");
- 导航传参与生命周期
传参:
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) { }
}
其他几个常用接口:
-
IConfirmNavigationRequest:离开前拦截,比如弹出"有未保存的修改,确定离开吗?"
-
IRegionMemberLifetime:
KeepAlive返回false时,View 离开后会被销毁,不留在 Region 里。 -
IRegionNavigationJournal:导航历史。在
OnNavigatedTo里保存context.NavigationService.Journal,之后调用GoBack()/GoForward()实现前进后退。 -
新手常见的坑 导航没反应也不报错:通常是 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 静态类统一管理,避免字符串拼写错误。