WPF Prism框架合集(4.Module)

導航

開發者博客
文檔學習
開發者平台

視頻教程地址

點擊觀看視頻教程

上一章回顧

• 什么是Region?
• 定義區域(Region)
• 區域適配器(RegionAdapters)
  這一章, 我們將講解Prism當中模塊的概念, 以及如何將模塊指定到Region當中。

什么是模塊(Module)?

本質上來說, 對於一個應用程序而言, 特定功能的所有View、Logic、Service等都可以獨立存在。那么意味着, 每個
獨立的功能我們都可以稱之為模塊。
而往往實際上, 我們在一個項目當中, 他的結構通常是如下所示:

所有的模塊都在一個項目當中, 這使得應用程序當中, 我們難以區分單獨的模塊, 它們似乎變成了一個整體。

所以,當我們開始考慮划分模塊之間的關系的時候, 並且采用新的模塊化解決方案, 它的結構將變成如下所示:

該項目包含了一個啟動頁, 並且在啟動頁當中,我們划分好了對應的區域。這個時候, 我們便可以靈活的配置我們的應用程序功能。

使用Prism提供強大的功能, 我們可以動態的加載應用程序模塊, 為指定的Region動態分配內容, 如下所示:

創建模塊(Create Module)

1.首先, 我們創建一個基於WPF的應用程序, 暫且定義為ModuleA, 接下來為ModuleA定義一個類,並且實現IModule接口。

public class ModuleAModule : IModule
    {
        /// <summary>
        /// 通知模塊已被初始化。
        /// </summary>
        /// <param name="containerProvider"></param>
        public void OnInitialized(IContainerProvider containerProvider)
        {
        }

        /// <summary>
        /// 用於在您的應用程序將使用的容器中注冊類型。
        /// </summary>
        /// <param name="containerRegistry"></param>
        public void RegisterTypes(IContainerRegistry containerRegistry)
        {
        }
    }

2.在啟動項目當中,添加ModuleA的應用, 打開App.xaml.cs, 重寫ConfigureModuleCatalog方法,如下所示:

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

        protected override void RegisterTypes(IContainerRegistry containerRegistry)
        {

        }

        protected override void ConfigureModuleCatalog(IModuleCatalog moduleCatalog)
        {
            //添加模塊A
            moduleCatalog.AddModule<ModuleAModule>();
        }
    }

疑問

不是說好了模塊化, 你在這里顯示指定添加模塊, 相當於不就是代碼換了一個位置嗎？
問得好！那么在Prism當中, 有多種方式可以加載我們的模塊, 如下所示:
Module Catalog

• (代碼方式)Code
• (配置文件)App.config
• (磁盤目錄)Disk/Directory
• (XAML定義)XAML
• (自定義)Custom
  Register Catalog with PrismApplication
  Register Modules with Catalog

Directory配置模塊目錄

通過讀取根目錄Modules文件夾查找模塊

 public partial class App
    {
        protected override IModuleCatalog CreateModuleCatalog()
        {
            return new DirectoryModuleCatalog() { ModulePath=@".\Modules" };
        }
    }

App.Config配置模塊目錄

 public partial class App
    {
        protected override IModuleCatalog CreateModuleCatalog()
        {
            return new ConfigurationModuleCatalog();
        }
    }

然后,為應用程序添加配置文件app.config, 添加以下內容:

<configuration>
  <configSections>
    <section name="modules" type="Prism.Modularity.ModulesConfigurationSection, Prism.Wpf" />
  </configSections>
  <startup>
  </startup>
  <modules>
    <module assemblyFile="ModuleA.dll" moduleType="ModuleA.ModuleAModule, ModuleA, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" moduleName="ModuleAModule" startupLoaded="True" />
  </modules>
</configuration>

XAML配置模塊目錄

修改CreateModuleCatalog方法, 從指定XAML文件讀取模塊配置

    public partial class App
    {
        protected override IModuleCatalog CreateModuleCatalog()
        {
            return new XamlModuleCatalog(new Uri("/Modules;component/ModuleCatalog.xaml", UriKind.Relative));
        }
    }

創建模塊名為ModuleCatalog.xaml文件, 添加模塊信息

<m:ModuleCatalog xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
                    xmlns:m="clr-namespace:Prism.Modularity;assembly=Prism.Wpf">

    <m:ModuleInfo ModuleName="ModuleAModule" 
                  ModuleType="ModuleA.ModuleAModule, ModuleA, 
                  Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />

</m:ModuleCatalog>

下一章預告

如何在模塊當中定義視圖, 並且作為依賴項注入, 最終顯示在應用程序指定的Region中。