Back to Devexpress

DevExpress Project Converter: Console Application

generalinformation-8409-updates-project-converter-cli.md

latest3.9 KB
Original Source

DevExpress Project Converter: Console Application

  • Feb 06, 2026
  • 3 minutes to read

Use the following syntax to run the Project Converter as a console application from the installation directory:

console
cd C:\Program Files\DevExpress 25.2\Components\Tools\Components\ProjectConverter
ProjectConverter-console.exe <drive:yourProjectPath> [options]

If the conversion is successful, ProjectConverter-console.exe returns 0 as an exit code. It returns 1 if there were warnings, and -1 in case of an error.

Command Line Options

/?Displays a help page.<drive:yourProjectPath>Specifies the single path that contains the project(s) to upgrade./fl:<drive:yourFilePath>Specifies the path to the file that contains a list of folders to upgrade. The file should be a plain text file with one folder path per line.

Target DevExpress-based Projects to .NET 8 and .NET Framework 4.6.2

Note

.NET 8, .NET Framework 4.6.2, Visual Studio 2019 are minimally supported versions for DevExpress libraries in v25.2. Refer to the following breaking change article for additional information: .NET 8 and .NET Framework 4.6.2 are minimally supported Target Frameworks for DevExpress libraries in v24.2.

When you update the DevExpress-powered project that targets .NET Framework 4.5.2 / .NET 6 (or earlier), the Project Converter displays a window that informs you that the Project Converter will re-target DevExpress-based projects to .NET 8 and .NET Framework 4.6.2 and update 3rd party NuGet packages to the latest compatible versions.

Use the following command line options to disable automatic updates if you want to update DevExpress-powered projects manually:

/noautoupdateDisables automatic update of the TargetFrameworkVersion and 3rd-party NuGet packages for projects with DevExpress dependencies based on the latest version compatible with the target framework./noautoupdatepkgDisables automatic update of 3rd-party NuGet packages for projects with DevExpress dependencies based on the latest version compatible with the target framework.

Read the following help topic for additional information: Target DevExpress-based Projects to .NET 8 and .NET Framework 4.6.2.

Additional Options

You can change the default Project Converter behavior and add the following options:

/topackagesConverts DevExpress assembly references (DLLs) to corresponding NuGet package references. Read the following help topic for additional information: Migrate DevExpress-Powered .NET Framework Apps to the Latest .NET Version./oSkips subdirectories and upgrades only files in the specified directory./roSkips read-only files./h:remove

Removes hint paths (the default behavior for versions prior to v21.2.4).

Tip

Choose this option if project assemblies are loaded from the installation directory.

/h:update

Updates hint paths (the default behavior for versions v21.2.5+).

Tip

Choose this option if project assemblies are loaded from a custom directory.

/bDoes not create backup files./d:skippedDisables skipped file notifications./d:warningDisables warning notifications./d:errorDisables error notifications./k:<yourPublicKeyToken>Allows you to specify your public key token if you purchased the DevExpress assemblies’ source code and compiled your version with a custom public key token. See Also

Type 'X' exists in both assemblies / Type 'X' is ambiguous in namespace 'Y'