XAF共享模块在.NET Framework与.NET Core间的复用实践-代码聚汇网

XAF共享模块在.NET Framework与.NET Core间的复用实践

北陌大叔·2026-08-11·阅读 23 GEO检测（免费）

XAF框架.NET Standard代码复用

|难度：普通|阅读约 18 分钟

1. 项目概述：XAF共享模块的跨框架复用挑战

在.NET生态系统的演进过程中，最让开发者头疼的问题之一就是如何让为.NET Framework编写的代码平滑迁移到.NET Core/.NET 5+环境。我最近接手的一个企业级项目恰好面临这个典型场景——客户需要将基于DevExpress XAF（eXpressApp Framework）开发的财务模块同时运行在传统.NET Framework 4.8和现代.NET 6平台上。这个02.02版本的需求文档标题直接点出了核心诉求："Reuse an XAF Shared Module between .NET Framework and .NET Applications"。

XAF作为DevExpress旗下的快速应用开发框架，其模块化设计本应支持代码复用，但当混合使用不同.NET运行时版本时，事情就变得复杂起来。经过三周的实战调试，我总结出一套可行的解决方案，特别适合需要同时维护新旧系统的团队参考。下面将从技术选型到具体实现，完整还原这个典型跨框架复用案例的解决过程。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 技术背景与需求解析

2.1 XAF框架的模块化架构特点

XAF的核心价值在于其"一次开发，多端部署"的能力。通过Business Object（业务对象）、Controllers（控制器）和Module（模块）的三层抽象，开发者可以快速构建同时支持WinForms、ASP.NET WebForms和ASP.NET Core的LOB（Line-of-Business）应用。其模块化设计允许将功能拆分为独立组件，这正是实现跨框架复用的理论基础。

典型的XAF模块包含以下关键部分：

业务实体类（继承自XPO或EF Core的持久化对象）
View控制器（处理UI逻辑）
模块类（继承自ModuleBase的入口点）
各种资源文件（本地化字符串、图像等）

2.2 .NET Framework与.NET Core的兼容性差异

虽然微软通过.NET Standard提供了基础API的兼容层，但在实际开发中仍会遇到诸多陷阱：

依赖注入差异：
- .NET Framework使用Unity或MEF
- .NET Core内置轻量级DI容器
配置文件系统：
- .NET Framework依赖web.config/app.config
- .NET Core改用appsettings.json
HTTP管道区别：
- ASP.NET WebForms的Page生命周期
- ASP.NET Core的Middleware管道
第三方库兼容性：
特别是像DevExpress组件这类深度集成框架的套件

3. 共享模块的设计策略

3.1 项目结构规划

经过多次迭代，最终采用的多目标框架项目结构如下：

code复制SharedModule/
├── src/
│   ├── SharedModule.Core/          # .NET Standard 2.0类库
│   │   ├── BusinessObjects/        # 业务实体
│   │   ├── Services/               # 领域服务
│   │   └── Module.cs               # 核心模块定义
│   │
│   ├── SharedModule.Web/           # ASP.NET专用扩展
│   │   ├── Controllers/            # Web控制器
│   │   └── Module.Web.cs           # Web模块扩展
│   │
│   └── SharedModule.Win/           # WinForms专用扩展
│       ├── Controllers/            # Windows控制器
│       └── Module.Win.cs           # Win模块扩展
│
├── tests/                          # 单元测试项目
└── samples/                        # 各平台示例代码

3.2 关键实现技术点

3.2.1 条件编译的合理运用

在共享代码中大量使用#if NETFRAMEWORK和#if NETCOREAPP指令处理平台差异：

csharp复制public class CrossPlatformService
{
    public string GetConfigValue(string key)
    {
#if NETFRAMEWORK
        return ConfigurationManager.AppSettings[key];
#else
        return Configuration[key]; // .NET Core的IConfiguration
#endif
    }
}

3.2.2 抽象工厂模式解耦平台实现

为UI相关的功能创建抽象工厂接口：

csharp复制public interface IUIServiceFactory
{
    IMessageService CreateMessageService();
    IDialogService CreateDialogService();
}

// .NET Framework实现
public class WinFormsUIServiceFactory : IUIServiceFactory { ... }

// .NET Core实现
public class BlazorUIServiceFactory : IUIServiceFactory { ... }

3.2.3 模块加载器的动态适配

通过反射动态加载平台特定模块：

csharp复制public void LoadPlatformModules(ModuleList modules)
{
    modules.Add(new SharedModuleCore());
    
    var platformModuleType = Type.GetType(
        "SharedModule." + (IsNetFramework ? "Web" : "AspNetCore") + ".Module");
    
    if (platformModuleType != null)
    {
        modules.Add((ModuleBase)Activator.CreateInstance(platformModuleType));
    }
}

4. 具体实现步骤

4.1 创建多目标框架项目

使用VS2022新建Class Library项目
编辑.csproj文件配置多目标：

xml复制<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>netstandard2.0;net48</TargetFrameworks>
    <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
  </PropertyGroup>

  <!-- 条件引用不同平台的DevExpress包 -->
  <ItemGroup Condition="'$(TargetFramework)' == 'net48'">
    <PackageReference Include="DevExpress.ExpressApp" Version="22.1.5" />
  </ItemGroup>
  
  <ItemGroup Condition="'$(TargetFramework)' == 'netstandard2.0'">
    <PackageReference Include="DevExpress.ExpressApp.Core" Version="22.1.5" />
  </ItemGroup>
</Project>

4.2 处理XPO持久层的兼容性

XAF默认使用XPO（eXpress Persistent Objects）作为ORM，需要特别注意：

csharp复制public class SharedDbContext : XPDictionary
{
    protected override void RegisterEntities()
    {
        // 统一注册实体类
        this.RegisterEntity(typeof(Customer));
        this.RegisterEntity(typeof(Order));
        
        // .NET Core需要额外配置
#if NETCOREAPP
        this.ConnectionString = Configuration.GetConnectionString("Default");
#endif
    }
}

4.3 实现跨平台的视图控制器

视图控制器需要区分Web和Windows平台：

csharp复制public abstract class SharedViewController : ObjectViewController
{
    // 公共逻辑
    protected override void OnActivated()
    {
        base.OnActivated();
        // 通用初始化代码
    }

    // 平台特定实现
    protected abstract void PlatformSpecificSetup();
}

// WinForms实现
public class WinSharedViewController : SharedViewController
{
    protected override void PlatformSpecificSetup()
    {
        // Ribbon按钮配置等
    }
}

// Blazor实现
public class BlazorSharedViewController : SharedViewController
{
    protected override void PlatformSpecificSetup()
    {
        // 工具栏命令绑定等
    }
}

5. 调试与部署实战

5.1 NuGet包的特殊处理

由于需要支持不同平台，打包时需要包含不同目标框架的构建结果：

xml复制<PropertyGroup>
  <PackageId>Company.SharedModule</PackageId>
  <Version>2.2.0</Version>
  <IncludeBuildOutput>true</IncludeBuildOutput>
  <NoPackageAnalysis>true</NoPackageAnalysis>
</PropertyGroup>

<ItemGroup>
  <Content Include="platforms\net48\*.dll" PackagePath="lib\net48" />
  <Content Include="platforms\netstandard2.0\*.dll" PackagePath="lib\netstandard2.0" />
</ItemGroup>

5.2 运行时配置策略

使用JSON配置适配各平台：

json复制// sharedconfig.json
{
  "ConnectionStrings": {
    "Default": "Server=.;Database=SharedDB;Trusted_Connection=True;"
  },
  "ModuleSettings": {
    "FeatureFlags": {
      "AdvancedReporting": true
    }
  }
}

在.NET Framework项目中通过转换工具生成app.config：

xml复制<configuration>
  <appSettings>
    <add key="ConnectionStrings:Default" 
         value="Server=.;Database=SharedDB;Trusted_Connection=True;"/>
  </appSettings>
</configuration>

6. 典型问题排查指南

6.1 类型加载异常（TypeLoadException）

现象：在.NET Core应用中加载.NET Framework编译的模块时抛出异常

解决方案：

检查所有公共类型是否都定义在.NET Standard项目中
确保没有在共享代码中使用平台特定的API
使用<ExcludeAssets>runtime</ExcludeAssets>排除冲突的依赖项

6.2 视图控制器未生效

可能原因：

平台特定的控制器没有被正确注册
条件编译导致控制器代码被排除

调试步骤：

在Module的Setup方法中添加日志输出
使用XAF的ApplicationDesignManager检查控制器注册情况
确认.Controllers命名空间约定被遵守

6.3 设计时与运行时行为不一致

典型案例：在VS设计器中正常，但运行时崩溃

处理方法：

实现IDesignTimeServices接口提供设计时替代实现
使用DesignMode属性进行分支处理：

csharp复制if (Component.DesignMode)
{
    // 设计时模拟数据
}
else
{
    // 运行时真实逻辑
}

7. 性能优化建议

延迟加载平台特定组件：
使用Lazy<T>包装重量级的平台相关服务
缓存反射结果：
对频繁使用的Type对象进行缓存：

csharp复制private static readonly ConcurrentDictionary<string, Type> _typeCache = new();

public static Type GetPlatformType(string name)
{
    return _typeCache.GetOrAdd(name, n => 
        Type.GetType($"SharedModule.Platform.{n}"));
}

AOT编译友好设计：
为将来支持Native AOT做准备，避免过度依赖反射：

csharp复制[ModuleInitializer]
public static void RegisterPlatformTypes()
{
    TypeRegistry.Register<WinFormsServiceFactory>("Windows");
    TypeRegistry.Register<BlazorServiceFactory>("Web");
}

8. 扩展思考：Blazor集成方案

随着ASP.NET Core Blazor的普及，XAF模块也可以扩展支持WebAssembly：

csharp复制// 在Blazor项目中注册XAF服务
builder.Services.AddXafApplication(application => {
    application.Modules.Add(new SharedModuleCore());
    application.Modules.Add(new SharedModuleBlazor());
    
    // 配置Blazor特定的选项
    application.SetupBlazor(builder.Configuration);
});

关键调整点：

替换XPO的数据访问层为REST API调用
实现Blazor专属的UI组件适配器
处理WebAssembly的静态资源加载

9. 版本升级策略

当需要从XAF 22.1升级到新版时：

分阶段升级：
- 先升级.NET Standard部分
- 再单独测试各平台实现
API变更处理：
使用Microsoft.CodeAnalysis.PublicApiAnalyzers跟踪公共API变化
兼容性测试清单：
- 数据库迁移脚本验证
- 权限系统兼容性
- 报表模块渲染一致性

经过这个项目的实战验证，我总结出XAF模块跨框架复用的三个黄金法则：1) 核心逻辑下沉到.NET Standard、2) 平台特性通过扩展点实现、3) 构建时严格隔离框架依赖。特别是在处理DevExtreme组件时，这种分层设计让UI适配变得可控。虽然初期搭建架构需要额外投入，但当看到同一套业务规则在WinForms和Blazor上同时完美运行时，所有的付出都值得了。