WPF Prism多模块Ribbon Tab加载异常问题咨询

问题背景 #

我拥有两个模块，每个模块对应一个Ribbon Tab。期望应用启动时加载这两个模块，并根据用户选中的Ribbon Tab进行模块切换，但目前仅能看到第一个注册的MonteuranforderungModule。尝试通过配置文件加载模块，结果仍未改善。

相关代码 #

App.xaml.cs #

using KDForms.Core.Regions;
using Monteuranforderung;
using Abholschein;
using KDForms.Views;
using Prism.Ioc;
using Prism.Modularity;
using Prism.Regions;
using Prism.Unity;
using System.Windows;
using Monteuranforderung.Views;

namespace KDForms
{
    /// <summary>
    /// Interaction logic for App.xaml
    /// </summary>
    public partial class App : PrismApplication
    {
        protected override Window CreateShell()
        {
            return Container.Resolve<MainWindow>();
        }

        protected override void InitializeShell(Window shell)
        {
            base.InitializeShell(shell);
        }

        protected override void RegisterTypes(IContainerRegistry containerRegistry)
        {
            
        }

        protected override void ConfigureModuleCatalog(IModuleCatalog moduleCatalog)
        {
            moduleCatalog.AddModule<MonteuranforderungModule>();
            moduleCatalog.AddModule<AbholscheinModule>();
        }

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

        protected override void ConfigureDefaultRegionBehaviors(IRegionBehaviorFactory regionBehaviors)
        {
            base.ConfigureDefaultRegionBehaviors(regionBehaviors);

            regionBehaviors.AddIfMissing(DependentViewRegionBehavior.BehaviorKey, typeof(DependentViewRegionBehavior));
        }
}

模块配置文件（App.config） #

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <configSections>
        <section name="modules" type="Prism.Modularity.ModulesConfigurationSection, Prism.Wpf"/>
    </configSections>

    <modules>
        <module assemblyFile="Monteuranforderung.dll" moduleType="Monteuranforderung.MonteuranforderungModule, Monteuranforderung, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null"  moduleName="Monteuranforderung" startupLoaded="true" />
        <module assemblyFile="Abholschein.dll" moduleType="Abholschein.AbholscheinModule, Abholschein, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null"  moduleName="Abholschein" startupLoaded="true"/>
    </modules>
</configuration>

FluentRibbonRegionAdapter.cs #

using Fluent;
using Prism.Regions;
using System;
using System.Collections.Specialized;

namespace KDForms.Core.Regions
{
    public class FluentRibbonRegionAdapter : RegionAdapterBase<Ribbon>
    {
        public FluentRibbonRegionAdapter(IRegionBehaviorFactory regionBehaviorFactory)
            : base(regionBehaviorFactory)
        {
        }

        protected override void Adapt(IRegion region, Ribbon regionTarget)
        {
            if (region == null) throw new ArgumentNullException(nameof(region));
            if (regionTarget == null) throw new ArgumentNullException(nameof(regionTarget));

            region.Views.CollectionChanged += (s, e) =>
            {
                if (e.Action == NotifyCollectionChangedAction.Add)
                {
                    foreach (var view in e.NewItems)
                    {
                        AddViewToRegion(view, regionTarget);
                    }

                }
                else if (e.Action == NotifyCollectionChangedAction.Remove)
                {
                    foreach (var view in e.OldItems)
                    {
                        RemoveViewFromRegion(view, regionTarget);
                    }
                }
            };
        }

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

        static void AddViewToRegion(object view, Ribbon FluentRibbon)
        {
            if (view is RibbonTabItem ribbonTabItem)
            {
                FluentRibbon.Tabs.Add(ribbonTabItem);
            }
        }

        static void RemoveViewFromRegion(object view, Ribbon FluentRibbon)
        {
            if (view is RibbonTabItem ribbonTabItem)
            {
                FluentRibbon.Tabs.Remove(ribbonTabItem);
            }
        }
    }
}

排查与解决步骤 #

1. 检查第二个模块的初始化逻辑 #

确保AbholscheinModule的Initialize方法正确将其RibbonTab视图注册到Ribbon区域中。示例代码如下：

public class AbholscheinModule : IModule
{
    private readonly IRegionManager _regionManager;

    public AbholscheinModule(IRegionManager regionManager)
    {
        _regionManager = regionManager;
    }

    public void Initialize()
    {
        // 替换为你实际的Ribbon区域名称
        _regionManager.RegisterViewWithRegion("RibbonRegion", typeof(AbholscheinRibbonTab));
        // 或者直接添加视图实例：
        // _regionManager.AddToRegion("RibbonRegion", Container.Resolve<AbholscheinRibbonTab>());
    }
}

如果模块未执行此操作，对应的RibbonTab不会被添加到区域中，自然无法显示。

2. 验证模块是否被正确加载 #

• 检查输出目录（如bin/Debug）是否存在Abholschein.dll和相关依赖文件，确保编译时已将模块项目的输出复制到主应用目录。
• 在AbholscheinModule的Initialize方法中添加调试断点或日志输出，确认模块是否被Prism正确初始化。

3. 确认Ribbon区域的绑定正确性 #

检查MainWindow.xaml中的Fluent Ribbon控件是否正确绑定了Prism区域，示例：

<fluent:Ribbon prism:RegionManager.RegionName="RibbonRegion" />

确保区域名称与模块中注册视图时使用的名称完全一致，否则视图无法关联到目标Ribbon。

4. 调整区域类型（可选） #

当前FluentRibbonRegionAdapter使用SingleActiveRegion，该区域允许存在多个视图但仅激活一个。如果你的需求是同时显示所有RibbonTab，可考虑替换为AllActiveRegion：

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

不过Ribbon本身支持同时显示多个Tab，SingleActiveRegion并不影响Tab的显示，仅影响视图的激活状态，所以这一步通常不是必须的，但可以作为排查方向。

内容的提问来源于stack exchange，提问作者Alexander Fedorov