Moving Projects to MM .NET 10.0.0

Moving an MM .NET Project to MM .NET 2026 10.0.0

To move an existing MM .NET project to MM .NET 2026 10.0.0, you must first migrate the project to .NET 10 and then update its MM .NET references. The steps below walk you through this process.

Moving Windows Forms Projects to .NET 10

Before upgrading a Windows Forms MM .NET project to MM .NET 2026, you must migrate the project itself to .NET 10.

Microsoft provides official guidance for migrating Windows Forms projects from .NET Framework to modern .NET:

https://learn.microsoft.com/dotnet/desktop/winforms/migration/

Some legacy Windows Forms controls are no longer available or have been replaced in modern .NET. Review the following compatibility notes carefully:

https://learn.microsoft.com/dotnet/core/compatibility/winforms

If your application still uses legacy controls such as MainMenu or ToolBar, they should be upgraded to MenuStrip and ToolStrip. The following article provides helpful background:

https://www.codeproject.com/Articles/12953/Upgrading-from-MainMenu-and-ToolBar-to-MenuStrip-a

Moving All Project Types to MM .NET 2026

The steps in this section apply to all MM .NET project types, including Windows Forms, WPF, and business object libraries.

1. Open the project in Visual Studio 2026

Open your solution in Visual Studio 2026.

2. Update the target framework to .NET 10

If the project is not already targeting .NET 10:

Right-click the project in Solution Explorer
Select Properties
Go to the Application tab
Change Target Framework to .NET 10

Visual Studio will update the project to an SDK-style format if it has not already been converted.

3. Remove existing MM .NET assembly references

In Solution Explorer:

Expand the References node
Select all existing MM .NET assembly references
Right-click and choose Remove

Important:
MM .NET 2026 no longer installs assemblies into the GAC or registers them via AssemblyFolders. Existing direct assembly references must be removed before adding the updated MM .NET references.

4. Add MM .NET 2026 references

Reference the MM .NET assemblies from:

C:\Program Files\OakLeaf\MM.NET\2026\10.0.0\Assemblies

Entity Framework Upgrades

Moving to Entity Framework 6.4 (from 6.2 or newer)

If your project already uses EF 6.2 or newer:

Right-click the project
Select Manage NuGet Packages
Upgrade EntityFramework to 6.4

Moving to Entity Framework 6.4 (from EF 6.1 or older)

If your project uses EF 6.1 or earlier, perform the following steps:

Upgrade EntityFramework to 6.4 via NuGet
Replace your existing EntityDataModel.tt file with the updated version from the MM .NET 2026 samples
Perform the following search-and-replace operations in your business object project:

Search:
System.Data.EntityClient

Replace:

System.Data.Entity.Core.EntityClient

Search:
System.Data.Objects

Replace:
System.Data.Entity.Core.Objects

For additional details, see Microsoft’s documentation:

https://learn.microsoft.com/ef/ef6/upgrading/upgrading-to-ef6

Summary

MM .NET 2026 targets .NET 10 and Visual Studio 2026
AssemblyFolders and GAC-based referencing are no longer supported
EF 6.4 is required for modern MM .NET projects
SDK-style project conventions are fully supported and recommended