Skip to main content
BuyLog In
XAF: Cross-Platform .NET App UI & Web API
Search in…
Docs > Task-Based Help > Business Model Design > Common Tasks > How to: Recompile the Business Class Library
A newer version of this page is available. .
All docs
V18.2
eXpressApp Framework
Fundamentals
Getting Started
Concepts
Design-Time Features
Deployment
Task-Based Help
Business Model Design
Common Tasks
How to: Recompile the Business Class Library
How to: Specify a Display Member (for a Lookup Editor, Detail Form Caption, etc.)
How to: Use Both Entity Framework and XPO in a Single Application
Entity Framework (EF)
eXpress Persistent Objects (XPO)
Non-Persistent Objects
Application Model
Actions
Navigation
Views
List Editors
Property Editors
Templates
Filtering
Reporting
Dashboards
Scheduler and Notifications
Maps
Security
Workflow
Localization
Testing
Miscellaneous UI Customizations
Frequently Asked Questions (FAQ)
API Reference
Download CHM

How to: Recompile the Business Class Library

  • 2 minutes to read

The eXpressApp Framework supplies the Business Class Library that consists of three assemblies.

Assembly Description
DevExpress.Persistent.BaseImpl.v18.2.dll Contains ready-to-use XPO persistent classes.
DevExpress.Persistent.BaseImpl.EF.v18.2.dll Contains ready-to-use Entity Framework Code First classes.
DevExpress.Persistent.Base.v18.2.dll Contains interfaces and helper classes used in XAF Extra Modules. Classes implementing these interfaces are available in the two DevExpress.Persistent.BaseImpl.* assemblies listed above.

You can modify and recompile an assembly with ready-to-use XPO or EF entities using the steps below.

  • Run the Visual Studio Command Prompt as an administrator and execute the Sn.exe (Strong Name Tool) utility with the following parameters.

    sn -k "%PROGRAMFILES(x86)%\DevExpress 18.2\Components\Sources\DevExpress.Key\StrongKey.snk"

    This will create the strong name file (see Strong-Named Assemblies).

  • Navigate to one of the following folders.

    • %PROGRAMFILES(x86)%\DevExpress 18.2\Components\Sources\DevExpress.Persistent\DevExpress.Persistent.BaseImpl - if you use XPO.
    • %PROGRAMFILES(x86)%\DevExpress 18.2\Components\Sources\DevExpress.Persistent\DevExpress.Persistent.BaseImpl.EF - if you use EF.

    Open the DevExpress.Persistent.BaseImpl.csproj or DevExpress.Persistent.BaseImpl.EF.csproj project in Visual Studio.

  • If you use EF, ensure that the EntityFramework.dll assembly is available. The project already includes a reference to this assembly, but you may need to provide the DLL file. You can download it from NuGet, or copy it from the EF Demo project (%PUBLIC%\Documents\DevExpress Demos 18.2\Components\eXpressApp Framework\EFDemoCodeFirstCS\EFDemo.Module\lib\EntityFramework.dll).
  • Modify any class from the opened project.

  • Compile the project by clicking Rebuild in the context menu invoked for the solution. Once this rebuild is successful, the default assembly located in the %PROGRAMFILES(x86)%\DevExpress 18.2\Components\Bin\Framework folder will be replaced with the modified assembly.

    Note

    • By default, the same path is used for XAF solution references. If you use an alternate path, copy the created DevExpress.Persistent.BaseImpl.v18.2.dll or DevExpress.Persistent.BaseImpl.EF.v18.2.dll assembly to the appropriate location.
    • Some XPO-only modules (Audit Trail and Clone Object) have references to the DevExpress.Persistent.BaseImpl.v18.2.dll library. If you are using these modules in your application, they must be rebuilt too. Refer to the How to rebuild assemblies from the source code article for details.