To Migrate C# or VB.NET Projects

Reference documents

• Install .NET Upgrade Assistant
• Upgrade Assistant Overview
• Upgrade Assistant for WinForms and .NET Framework
• Porting to .NET Core
• Modernizing .NET Applications

To migrate a C# or VB.NET Project

1. Install the .NET Upgrade Assistant plugin.
   
2. Right-click on the project in the Solution Explorer window, and select Upgrade.
   
3. Select Upgrade project to a newer .NET version.
   
4. Select your upgrade type.
   
5. Select .NET 8.0 as the project target framework.
   
6. Select components to upgrade and click the Upgrade selection button.
   
7. Check the result.
   
8. Manually replace the reference DLLs with the .NET 8 version DLLs.
   
9. To ensure the output DLL is generated to the correct folder, add the following properties to .csproj:

   <PropertyGroup>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
     <AppendRuntimeIdentifierToOutputPath>false</AppendRuntimeIdentifierToOutputPath>
   </PropertyGroup>

10. Rebuild the plugin projects.
11. In your PackageContents.xml file, be sure to set both SeriesMin and SeriesMax to "R25.0" and Platform to "Civil3D" to ensure it can be loaded and is only loaded in Civil 3D 2025. See more details on AutoCAD 2024 Developer and ObjectARX Help | Runtime Requirements Element Reference

    <RuntimeRequirements SeriesMin="R25.0" SeriesMax="R25.0" Platform="Civil3D" OS="Win64"/>