zoukankan      html  css  js  c++  java
  • 一、从GitHub浏览Prism示例代码的方式入门WPF下的Prism

    最近这段时间一直在看一个开源软件PowerToys的源码,里面使用Modules的开发风格让我特别着迷,感觉比我现在写代码的风格好了太多太多。我尝试把PowerToys的架构分离了出来,但是发现代码维护量比较大,我自己很难维护这一套东西,就想到了同类型的Prism。
    之前一直使用MVVMLight进行开发。因为最近要写一个开源的财务软件,想在项目中使用Prism,所以这个系列是财务软件的前置系列Prism从0到入门。主要是对照Prism官方例子去学一遍他的代码并整理成自己的代码。然后尝试理解Prism中体现的编程思想。以及如何在我们自己的项目中更好的使用Prism。

    PrismLibrary/Prism-Samples-Wpf: Samples that demonstrate how to use various Prism features with WPF (github.com)

    打开连接后有一个README.md。里面是Prism Samples WPF。1到29个示例包含了Prism的主要内容。这个系列我们就学习这个,并在学习完成后结合实践到自己的项目中。

    一、浏览PrismSamples中的目录结构了解怎么学Prism;

    简单浏览了一下,发现第07的Modules 分为了5种不同的方式,需要梳理的时间比较多,而01-06内容比较少,第一篇就先写到07之前,我们看到示例代码中BootstrapperShell(引导程序外壳)、Regions(区域)、CustomRegions(自定义区域)、ViewDiscovery (我理解为Register View WithRegion区域选项卡查看,把某个视图通过RegionManager放在某个位置)、ViewInjection(视图注入)、ViewActivationDeactivation(视图的激活和取消激活)。

    现在开始学习示例代码。打开01BootstrapperShell的代码,我们进行观察;

    1、App.xaml中主要修改

    删掉了StartupUri属性,没有额外的代码。

    2、App.cs中主要修改

    App依然继承自Application,在重写OnStartup中实例化了Bootstrapper类,然后调用Bootstrapper实例后的对象的.Run()方法进行启动。

    3、查看BootStrapper.cs

    双击BootStrapper.cs打开源码看到了。包含了2个重写的方法CreateShell()方法返回一个DependencyObject。和一个没有返回值的RegisterTypes()方法。在学习WPF教程四的时候,我们讲到了DependencyObject对象,我们了解到DependencyObject所有的子对象都支持依赖项属性。包括UI控件。而CreateShell()方法返回的是一个DependencyObject类型,传入了Views文件夹下的MainWindow.xaml。

    4、在MainWindow.xaml中主要变化

    只有一个ContentControl,显示一串字符串“Hello from Prism”。

    5、运行代码

    发现打开了一个标题为Shell的窗体显示了Hello from Prism。就是我们的MainWindow。这里CreateShell()函数就是修改启动起始页面的地方。先不分析,继续看下一个Samples。

    protected override Window CreateShell()
            {
                return Container.Resolve<MainWindow>();
            }
    

    总结例子01:在CreateShell()中传入的MainWindow是设置默认启动页面,使用容器解析了MainWindw 并返回。(我们只学习代码,不考虑设计启动逻辑,单例等等。不在这里学习,只学Samples代码。)

    观察02Regions示例;

    1、App .xaml中主要修改

    App.xaml中 添加命名空间 xmlns:prism="http://prismlibrary.com/";

    更换Application为prism:下的PrismApplication。

    移除了StartupUri属性。

    2、App.cs中主要修改

    修改App继承自PrismApplication;

    重写CreateShell()方法;

    返回结果是使用Container.Resolve()容器解析出来的MainWindow窗体。

     protected override Window CreateShell()
            {
                return Container.Resolve<MainWindow>();
            }
    

    Views下的MainWindow.xaml

    创建了一个ContentControl控件,用于显示内容,并添加了附加依赖项属性prism:RegionManager.RegionName="ContentRegion" 。cs代码中无更新内容。

    启动程序,界面无任何内容。

    总结:在ContentControl控件中添加了附加依赖项属性,从命名看,是区域管理类下的区域名称设置为ContentRegion。

    观察03CustomRegions示例;

    1、App.xaml中主要修改

    添加了 xmlns:prism="http://prismlibrary.com/"命名空间;修改了Application类为PrismApplication。

    2、App.cs中主要修改

    修改了App继承自PrismApplication。重写了CreateShell()方法,并且返回值修改为Window,同样使用了Container.Resolve()的方式设置默认启动窗体。重写了ConfigureRegionAdapterMappings()方法,我们在PrismApplication使用F12跳转过去,看到在PrismApplication下没有ConfigureRegionAdapterMappings()方法,继续PrismAoolicationBase上F12,我们看到了ConfigureRegionAdapterMappings()方法点开注释,看到提示(翻译后):配置要在应用程序中使用的默认区域适配器映射,以便使XAML中定义的UI控件适配为使用区域并自动注册。可以在派生类中重写,以添加应用程序所需的特定映射。 返回结果(翻译后)为包含所有映射的Prism.Regions.RegionAdapterMappings实例。在搭配这个方法名和参数,我们大概了解到这个方法应该是配置区域适配器映射。我们搭配代码详细看一下。调用了父类的ConfigureRegionAdapterMappings()方法后,用使用传入参数的regionAdapterMappings.RegisterMapping()方法,传入了stackPanel,和Container.resolve(),使用regionAdapterMappings注册一个容器解析的StackPanelRegionAdapter的类。因为regionAdapterMappings是传入的对象,StackPanel又是布局的面便,所以我们去分析StackPanelRegionAdapter。

     protected override void ConfigureRegionAdapterMappings(RegionAdapterMappings regionAdapterMappings)
            {
                base.ConfigureRegionAdapterMappings(regionAdapterMappings);
                regionAdapterMappings.RegisterMapping(typeof(StackPanel), Container.Resolve<StackPanelRegionAdapter>());
            }
    

    3、分析StackPanelRegionAdapter

    我们看到StackPanelRegionAdapter是是在Prism文件夹。继承自RegionAdapterBase

    一个公共的空的构造函数;

    重写Adapt方法,并且传入了IRegion和StackPanel类型的参数,我们使用F12看到region.Views主要是获取区域中视图集合,所有添加视图的集合对象。这方法中使用传入的region.Views注册了CollectionChanged事件,这个事件主要是处理集合变更的消息;从这段代码看主要逻辑是传入的region如果集合发生了变化,如果是Add操作则把时间传入的控件添加到regionTarget中。

      protected override void Adapt(IRegion region, StackPanel regionTarget)
            {
                region.Views.CollectionChanged += (s, e) =>
                {
                    if (e.Action == System.Collections.Specialized.NotifyCollectionChangedAction.Add)
                    {
                        foreach (FrameworkElement element in e.NewItems)
                        {
                            regionTarget.Children.Add(element);
                        }
                    }
    
                    //handle remove
                };
            }
    

    一个CreateRegion()方法,F12看方法说明,是创建一个新的IRegion实例,用于调整对象。

      protected override IRegion CreateRegion()
            {
                return new AllActiveRegion();
            }
    

    3、Views 下的MainWindow.xaml

    我们看到在MainWindow下有一个StackPanel。设置了一个附加依赖项属性,并命名为ContentRegion。cs文件中什么也没有新增。

     <Grid>
            <StackPanel prism:RegionManager.RegionName="ContentRegion" />
        </Grid>
    

    4、我们运行代码。界面什么也没有。

    总结:这个例子在讲如何注册StakPanel,并通过在App下重写ConfigureRegionAdapterMappings()方法的方式,使用 regionAdapterMappings.RegisterMapping(typeof(StackPanel), Container.Resolve());的方式设置自定义面板区域适配器,然后再UI的XAML中通过附加依赖项属性的方式regionManager.regionName设置Name。先总结到这里,我们去看一下篇。

    观察04ViewDiscovery示例

    1、App.xaml

    添加命名空间xmlns:prism="http://prismlibrary.com/"

    修改Application为prism:PrismApplication

    去掉StartupUri属性

    2、App.cs

    重写CreateShell()方法。返回MainWindow。

     protected override Window CreateShell()
            {
                return Container.Resolve<MainWindow>();
            }
    

    3、Views下的MainWindow.xaml

    添加了ContentControl控件,设置了附加依赖项属性 prism:RegionManager.RegionName="ContentRegion"

    4、Views下的MainWindow.cs

    再构造函数中,使用传入的regionManager使用RegisterViewWithRegion方法,传入了一个ContentRegion字符串,和ViewA。

     public MainWindow(IRegionManager regionManager)
            {
                InitializeComponent();
                //view discovery
                regionManager.RegisterViewWithRegion("ContentRegion", typeof(ViewA));
            }
    

    我们在RegisterViewWithRegion上F12看注释,通过注册类型将视图与区域相关联。当显示区域get时,将使用ServiceLocator将此类型解析为一个具体实例。实例将被添加到区域的视图集合中,两个参数分别是与视图关联的区域的名称,要注册到的视图的类型;

    我就知道了,这里原来时使用regionMananger去注册关联一个区域名称,和一个视图对象。ContentRegion字符串是我们的ContentControl控件的附加依赖项属性,ViewA是我们的一个UserControl。

    4、View下的ViewA.xaml

    包含了一个38号大的字体显示内容为View A的TextBlock控件。CS文件中没有更改。

    5、运行程序

    界面上显示了View A。

    总结:App启动时通过重写CreateShell()方法使用Container.Resolve方法返回一个MainWindow;MainWindow界面有一个ContentControl显示控件,有一个附加依赖项属性,设置了区域名称为ContentRegion。在MainWindow的有参构造函数中使用区域管理器,注册了视图和显示区域的关联,传入了区域名称和视图类。视图类是自己的显示内容。通过这样的流程在MainWindow下通过RegisterViewWithRegion方法,关联了具有ContenRegion名称的附加依赖项属性和视图类,界面上就显示了关联的视图。

    观察05ViewInjection示例

    1、App.xaml

    添加了xmlns:prism="http://prismlibrary.com/" 命名空间

    修改Application为prism:PrismApplication。

    去掉StartupUri属性

    2、App.cs

    App继承自PrismApplication

    重写了CreateShell()方法,返回对象为Container.Resolve(); 解析后的MainWindow窗体,

    3、Views下的MainWindow.xaml

    创建了DockPanel ,设置最后一个元素填充剩余空间。创建Button按钮,填充在DockPanel面板的顶部,显示为Add View,创建Click事件,创建了ContentControl显示控件,设置附加依赖项属性RegionName,名字叫做ContentRegion。

       <DockPanel LastChildFill="True">
            <Button DockPanel.Dock="Top" Click="Button_Click">Add View</Button>
            <ContentControl prism:RegionManager.RegionName="ContentRegion" />
        </DockPanel>
    

    4、Views下的MainWindow.cs

    使用F12跳转到对应的接口说明

    IContainerExtension _container 对象是对容器的抽象。

    IRegionManager _regionManager; 是定义一个接口来管理一组区域并将区域附着到对象;

    构造函数中初始化了这2个对象,使用是在这个Button的点击事件中,我们看到了使用容器对象Resolve解析了ViewA界面,然后使用了IRegionManager对象找到了在XAML中定义的附加依赖项属性名为ContentRegion的控件,然后使用Add方法添加了容器中的ViewA

     public partial class MainWindow : Window
        {
            IContainerExtension _container;
            IRegionManager _regionManager;
    
            public MainWindow(IContainerExtension container, IRegionManager regionManager)
            {
                InitializeComponent();
                _container = container;
                _regionManager = regionManager;
            }
    
            private void Button_Click(object sender, RoutedEventArgs e)
            {
                var view = _container.Resolve<ViewA>();
                IRegion region = _regionManager.Regions["ContentRegion"];
                region.Add(view);
            }
        }
    

    5、Views下的ViewA.xaml

    是一个UserControl,里面只有一个TextBlock 显示内容为View A 字号为38。cs文件中没有额外的东西。

    6、运行代码,界面显示View A

    总结:在程序启动时更改Application类为PrismApplication,在重写CreateShell()方法时使用Container解析MainWindow窗体,并返回,作为启动窗体,在MainWindow被启动时,在构造函数中初始化了容器接口和区域管理对象。MainWindow界面中设置了显示控件和点击控件、显示控件设置了附加依赖项属性,用于做区域名称ContentRegion。在点击事件中,使用容器接口解析ViewA用户控件,并使用区域管理器查找名字为ContentRegion的区域(我们界面上的ContentControl),然后再调用这个区域返回对象的Add方法再找到的这个区域中显示我们刚才解析的ViewA自定义控件。

    观察06ViewActivationDeactivation示例

    1、App.xaml

    替换Application为PrismApplication,使用Prism框架的时候,我看到现在每个都替换了。所以这一部分后面再写到的时候我都...处理。

    (和前面一样的部分我就省略了)

    2、App.cs

    重写CreateShell(),解析MainWindow并返回,作为启动页面。

    (....)

    3、MainWindow.xaml

    创建DockPanel,用StackPanel嵌套4个Button,并 设置了显示控件ContenControl,添加附加依赖属性RegionName为ContentRegion。Button 从名字理解,主要是激活ViewA (Button_Click)取消激活ViewA(Button_Click_1);激活ViewB(Button_Click_2) 取消激活ViewB(Button_Click_3)。

      <DockPanel LastChildFill="True">
            <StackPanel>
                <Button Content="Activate ViewA" Click="Button_Click"/>
                <Button Content="Deactivate ViewA" Click="Button_Click_1"/>
                <Button Content="Activate ViewB" Click="Button_Click_2"/>
                <Button Content="Deactivate ViewB" Click="Button_Click_3"/>
            </StackPanel>
            <ContentControl prism:RegionManager.RegionName="ContentRegion" HorizontalAlignment="Center" VerticalAlignment="Center" />
        </DockPanel>
    

    4、Views下的MainWindow.cs

    定义了变量容器接口对象,区域管理对象,区域对象和两个ViewA、ViewB页面对象;

    构造函数中初始化了容器接口和区域管理对象、注册了loaded事件;

    再Loaded事件中,使用容器解析ViewA和ViewB并放入类的ViewA和ViewB对象;

    使用区域管理器获取界面上的ContentRegion区域对象,复制给类的_region对象,并再区域中添加ViewA和ViewB视图;

    Button下4个Click使用_region的Activate和Deactivate方法显示对应的ViewA和ViewB;

     private void Button_Click(object sender, RoutedEventArgs e)
            {
                //activate view a
                _region.Activate(_viewA);
            }
    
            private void Button_Click_1(object sender, RoutedEventArgs e)
            {
                //deactivate view a
                _region.Deactivate(_viewA);
            }
    
            private void Button_Click_2(object sender, RoutedEventArgs e)
            {
                //activate view b
                _region.Activate(_viewB);
            }
    
            private void Button_Click_3(object sender, RoutedEventArgs e)
            {
                //deactivate view b
                _region.Deactivate(_viewB);
            }
    

    5、Views下的ViewA.xaml和ViewB.xaml无特殊代码,就是显示对应的ViewA和ViewB;

    6、运行代码,点击不同的Button可以切换显示ViewA和ViewB,

    总结:MainWindow在构造函数中初始化了容器接口和区域管理对象,

    在loaded事件中初始化了用于显示的容器解析对象ViewA和ViewB,使用区域管理区查找我们在界面上通过附加依赖项属性定义的ContentRegion显示控件,并返回给一个IRegion区域对象,使用IRegion区域对象的Add方法,添加资源到区域中。

    在4个Button的Click事件中,主要是通过Activate和Deactivate方法来设置显示不同的ViewA和ViewB;

    因为07示例分为了5个不同加载Modules方式,我们第一篇就先学到这里。下面打开我们最开始创建的WPFPrismDemo,我们写一下代码回忆一下前面的内容;

    我们通过一个DEMO来掌握01-06的示例内容。

    二、创建PrismSamplesDemo

    打开VS创建WPF项目,我使用了.NET Framewrok 4.8框架。

    打开PrismLibrary/Prism: Prism is a framework for building loosely coupled, maintainable, and testable XAML applications in WPF, Xamarin Forms, and Uno / Win UI Applications.. (github.com) 这个是Prism的地址

    我们看到了。在WPF下,有一个Prism.DryIoc和Prism.Unity,我看评论说都说DryIoc的性能比Unity的好,所以我选用了DryIoc(我并没有验证这个性能问题,我只是找一个入手开始进入学习。)

    在创建的PrismSamplesDemo项目中点击解决方案右键=》管理Nuget包=》浏览中输入Prism.DryIoc=》选择安装最新版。就完成了Prism的安装,接下来我们学习示例。

    1、修改App.xaml

    添加xmlns:prism="http://prismlibrary.com/"命名空间

    修改Application为prism:PrismApplication

    移除StartupUri属性。

    2、修改App.cs

    修改App继承自PrismApplication

    重写CreateShell()用于设置初始显示窗口

      protected override Window CreateShell()
            {
                return Container.Resolve<MainWindow>();
            }
            //这个方法如果不重写则会编译报错。
            protected override void RegisterTypes(IContainerRegistry containerRegistry)
            {
                 
            }
    

    如果不重写RegisterTypes的话,编译会报错。

    3、修改MainWindow.xaml,使用ContentControl尝试设置显示区域。

    <Window x:Class="WPFPrismDemo.MainWindow"
            xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
            xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
            xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
            xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
            xmlns:prism="http://prismlibrary.com/"
            xmlns:local="clr-namespace:WPFPrismDemo"
            mc:Ignorable="d"
            Title="MainWindow" Height="450" Width="800">
        <DockPanel>
            <StackPanel>
                <Button Content="Activate View A" Click="ActivateViewA_Click"/>
                <Button Content="Deactivate View A" Click="DeactivateViewA_Click"/>
                <Button Content="Activate View B" Click="ActivateViewB_Click"/>
                <Button Content="Deactivate View B" Click="DeactivateViewB_Click"/>
            </StackPanel> 
            <ContentControl  prism:RegionManager.RegionName="ContentRegion" FontSize="30" VerticalAlignment="Center" HorizontalAlignment="Center"/>
        </DockPanel>
    </Window>
    
    

    这里你可以尝试使用其他的控件替换掉ContentControl,会报错。这个就是03示例里讲到的CustomRegions,Prism中实现了几个,但是有一些没有实现,所以需要自己写了,就参考02的例子,去写自己的就可以。

    4、添加Views文件夹,并添加ViewA和ViewB用户控件,用于作为显示对象。

    ViewA 添加TextBlock 显示ViewA

    ViewB 添加TextBlock 显示ViewB

    5、修改MainWindow.cs

    不要看06示例的代码,凭理解自己去写,有报错,就去对照示例代码,我在写的时候忘记了IContainerExtension怎么拼写、忘记了_container.Resolve解析视图后需要在__region中add这对象。不然无法Activate和Deactivate。

    代码如下:

    using Prism.Ioc;
    using Prism.Regions;
    using System.Windows;
    using WPFPrismDemo.Views;
    
    namespace WPFPrismDemo
    {
        /// <summary>
        /// MainWindow.xaml 的交互逻辑
        /// </summary>
        public partial class MainWindow : Window
        {
            IContainerExtension _container;
            IRegionManager _regionManager;
            IRegion _region;
            ViewA _viewA;
            ViewB _viewB;
            public MainWindow()
            {
                InitializeComponent();
            }
            public MainWindow(IContainerExtension container, IRegionManager regionManager)
            {
                InitializeComponent();
                _container = container;
                _regionManager = regionManager;
                this.Loaded += MainWindow_Loaded;
            }
    
            private void MainWindow_Loaded(object sender, RoutedEventArgs e)
            {
                _region = _regionManager.Regions["ContentRegion"];
                _viewA = _container.Resolve<ViewA>();
                _viewB = _container.Resolve<ViewB>();
                _region.Add(_viewA);
                _region.Add(_viewB);
            }
    
            private void ActivateViewA_Click(object sender, RoutedEventArgs e)
            {
                _region.Activate(_viewA);
            }
    
            private void DeactivateViewA_Click(object sender, RoutedEventArgs e)
            {
                _region.Deactivate(_viewA);
            }
    
            private void ActivateViewB_Click(object sender, RoutedEventArgs e)
            {
                _region.Activate(_viewB);
            }
    
            private void DeactivateViewB_Click(object sender, RoutedEventArgs e)
            {
                _region.Deactivate(_viewB);
            }
        }
    }
    
    

    03示例的CustomRegions,目前我们还没有用到,所以这里先不做例子去分析了。

    以上是01-06示例的学习,一共有29个示例。01-06我们学习了怎么修改PrismApplication、怎么重写启动页面,怎么设置区域附加依赖项属性,怎么实例化IRegionManager、IContainerExtension、IRegion,怎么使用Resolev、_region.Add、和Activate、Deactivate。目前就先学习这么多。

    我创建了一个C#相关的交流群。用于分享学习资料和讨论问题,这个propuev也在群文件里。欢迎有兴趣的小伙伴:QQ群:542633085

  • 相关阅读:
    什么叫TLD、gTLD、nTLD、ccTLD、iTLD 以及几者之间的关系
    socket
    windows下codeblocks报错undefined reference to `WSAStartup@8'|
    Codeforces 467C George and Job | DP
    51Nod 1049最大子段和 | 模板
    51Nod 最大子矩阵和 | DP
    AtomicInteger
    sun.misc.unsafe
    CAS
    java中的四种引用
  • 原文地址:https://www.cnblogs.com/duwenlong/p/15011519.html
Copyright © 2011-2022 走看看