上一章回顾

  • Prism框架与其它框架的区别
  • Prism当中的Binding用法
  • Command和CompositeCommand 用法

  • IEventAggregator 以及Filtering Events 用法本章节将讲解Prism当中的Navigation导航功能

    使用场景

    在普遍的业务场景当中, 必不可少的是页面切换, 而Prism就可以使用Navigation功能来进行页面导航, 在不同的场景当中会有各种用法, 例如在切换页面验证、传递参数、返回上一页、返回下一页等功能。

    导航的基本条件

  • 1.注册显示区域点击此处观看视频,关于区域的介绍

  • 2.注册导航页面

    1.注册导航

  • 注册视图类型或添加别名,如果为指定别名,名称默认为当中类型的名称

public class ModuleAModule : IModule
{
public void OnInitialized(IContainerProvider containerProvider)
{

  1.     }
  3.     public void RegisterTypes(IContainerRegistry containerRegistry)<br />        {<br />            _//添加别名 "CustomName"_<br />            containerRegistry.RegisterForNavigation<ViewA>("CustomName");<br />            _//默认名称 "ViewB"_<br />            containerRegistry.RegisterForNavigation<ViewB>();<br />        }<br />    }

  • 注册时,指定ViewModel或添加别名。

    public class ModuleAModule : IModule
    {
    public void OnInitialized(IContainerProvider containerProvider)
    {

    1.   }
    3.   public void RegisterTypes(IContainerRegistry containerRegistry)<br />        {<br />            _//指定ViewModel_<br />            containerRegistry.RegisterForNavigation<ViewA, ViewAViewModel>();<br />            _//指定ViewModel并且添加别名_<br />            containerRegistry.RegisterForNavigation<ViewB, ViewBViewModel>("CustomName");<br />        }<br />    }

2.使用导航

正如前面的章节所讲到, Region的注册以及管理、导航等, 我们可以使用IRegionManager接口,所以,我们现在便可以使用该接口实现导航功能, 如下所示:
IRegionManager regionManager = …;
regionManager.RequestNavigate(“RegionName”, “ViewName”);

可以注意点, 我们调用了IRegionManager接口的RequestNavigate方法, 并且传递了两个参数:

  • RegionName: 该参数为注册的区域名称
  • ViewName: 该参数实际为我们上面注册过的导航页, 字符串类型, 对应的是我们注册页面的nameof

    3.带参数导航

    正如,我们想要在导航页前, 传递一些参数, 则可以使用NavigationParameters, 如下所示:
    var param = new NavigationParameters();
    param.Add(“Parameter”, param);
    _regionManger.RequestNavigate(“RegionName”, “ViewName”, param);

//类似URL地址传递参数
_regionManger.RequestNavigate(“RegionName”, “ViewName?id=1&Name=xiaoming”);

疑问?

当我们使用导航为指定区域注册视图时, 我们怎么控制打开的过程? 所以, 下面我们将讲解一下INavigationAware接口。

INavigationAware

该接口包含3个方法, 每个方法中都包含当前导航的上下文, 如下所示:
public void OnNavigatedTo(NavigationContext navigationContext)
{

  1.     }
  3.     public bool IsNavigationTarget(NavigationContext navigationContext)<br />        {<br />            return true;<br />        }
  5.     public void OnNavigatedFrom(NavigationContext navigationContext)<br />        {
  7.     }
  • OnNavigatedTo: 导航完成前, 此处可以传递过来的参数以及是否允许导航等动作的控制。
  • IsNavigationTarget: 调用以确定此实例是否可以处理导航请求。否则新建实例

  • OnNavigatedFrom: 当导航离开当前页时, 类似打开A, 再打开B时, 该方法被触发。

    INavigationAware 执行流程

    WPF Prism框架合集(8.Navigation) - 图1

    获取导航请求参数

    正如上面所描述, 导航中允许我们传递参数, 用于在我们完成导航之前, 进行做对应的逻辑业务处理。这时候, 我们便可以在OnNavigatedTo方法中通过导航上下文中获取到传递的所有参数。如下:
    public void OnNavigatedTo(NavigationContext navigationContext)
    {
    var id = navigationContext.Parameters.GetValue(“id”);

    1.       var name = navigationContext.Parameters["Name"].ToString();<br />        }

IConfirmNavigationRequest

该接口继承于INavigationAware, 所以, 它多了一个功能: 允许用户针对导航请求进行拦截。
//多了一个回调函数, 该值觉得是否拦截该导航请求
void ConfirmNavigationRequest(NavigationContext navigationContext, Action continuationCallback);

IConfirmNavigationRequest 执行流程

WPF Prism框架合集(8.Navigation) - 图2

拦截导航请求

当打开新的导航时, 或许有些情况下你需要经过用户进行确认, 这个时候, IConfirmNavigationRequest接口可以满足需求, 如下:
public void ConfirmNavigationRequest(NavigationContext navigationContext, Action continuationCallback)
{
bool result = true;

  1.         if (MessageBox.Show("确认导航?", "温馨提示", MessageBoxButton.YesNo) == MessageBoxResult.No)<br />                result = false;
  3.         _//通过回调当前返回的确认结果,决定是否启动该导航_<br />            continuationCallback(result);<br />        }

Navigation Journal

导航日志, 其实就是对导航系统的一个管理功能, 理论上来说, 我们应该知道我们上一步导航的位置、以及下一步导航的位置, 包括我们导航的历史记录。以便于我们使用导航对应用程序可以灵活的控制。

IRegionNavigationJournal

该接口包含以下功能:

  • GoBack() : 返回上一页
  • CanGoBack : 是否可以返回上一页
  • GoForward(): 返回后一页
  • CanGoForward : 是否可以返回后一页

    1.示例(返回上一页)

    当导航日志当中,包含上一页的历史记录, 如下所示, D的前面有ABC的记录,所以对于D而言, 它可以返回上一页, 所以CanGoBack 为True。WPF Prism框架合集(8.Navigation) - 图3

    2.示例(返回下一页)

    当导航日志当中,包含下一个的历史记录,如下所示,D的后面有E的记录,所以对于D而言,它可以返回下一页,所以CanGoForward 为True。WPF Prism框架合集(8.Navigation) - 图4

    下一章预告

    本章主要讲解:1.注册及使用导航、传递参数2.INavigationAware接口作用及执行流程3.IConfirmNavigationRequest接口作用及执行流程4.IRegionNavigationJournal接口作用及执行流程
    下一章,我们将讲解在Prism当中的(DialogService)对话服务。