Dialog Window

There are two Project Converter tool versions. You can run it as a dialog window (the ProjectConverter.exe file), or as a console application (the ProjectConverter-console.exe file). This topic describes how you can upgrade your projects using the dialog window.

Run Dialog Window

The Project Converter dialog window can be invoked using one of the following ways:

  • From the DEVEXPRESS menu in the Visual Studio IDE;

    DevExpressMenu

  • From the Start menu of your Windows OS (All Programs | DevExpress 18.2 | Project Converter 18.2);
  • By running the ProjectConverter.exe command from the installation directory ("C:\Program Files (x86)\DevExpress 18.2\Components\Tools\Components\" by default).

With the Project Converter, you can upgrade your projects that are in the same path (the PATH tab) or multiple paths (the MY COLLECTION tab).

ProjectConverterDialog

  1. Specify the path to the project(s) you want to upgrade.

    Switch to the MY COLLECTION tab to specify multiple paths. This tab allows you to save the current folder list to a text file, or load a list from an existing text file.

  2. Modify the advanced conversion options (if necessary).
  3. Click the Upgrade All or Search and Select Projects button.

    • Upgrade All button - Starts a search for projects/web sites and then immediately starts converting found items.
    • Search and Select Projects button - Starts project searching and then displays a list of the located projects. You can choose which projects to upgrade.

Advanced Conversion Settings

The following conversion options are available in the Project Converter dialog:

Option

Description

Custom Public Key Token

Use this option to specify your public key token if you purchased the DevExpress assemblies' source code and compiled your version with a custom public key token.

Hint Path Behavior

Specifies how to treat HintPath attributes that contain paths to DevExpress assemblies.

Remove - removes HintPath attributes from the project file. This is the default option for most cases, especially if project assemblies are loaded from the installation directory.

Update - updates substrings in paths that contain an old version number with a new version number. Choose this option if project assemblies are loaded from a custom directory (not from the installation directory).

Process Subdirectories

If enabled, files in nested folders are also upgraded. Otherwise, only files in the specified directory are upgraded.

Create Backup Files

If enabled, the Project Converter creates copies of the upgraded files before modifying them (the .bak extension is added to these copies).

Process Read-Only Files

If enabled, read-only files are also upgraded without prompting. Otherwise, Project Converter displays a confirmation dialog before upgrading each read-only file it finds.

Ask to Upgrade a Project in Visual Studio

If enabled, the Project Converter analyzes every project opened in Visual Studio and displays a dialog suggesting that you upgrade your project if it contains references to outdated DevExpress assemblies:

UpgradePrompt

Note that when you run the Project Converter from the command line, it is possible to specify default values for some of these options, as well as perform other actions. Use the following syntax from the command line to run the Project Converter:

ProjectConverter.exe [projectPath] [options]

In the above syntax, projectPath specifies the path to the files that should be upgraded, and options represent an option or set of options from the table below.

Option

Description

/s

Automatically starts conversion. The Project Converter does not close when the conversion is complete.

/sc

Automatically starts conversion. The Project Converter closes when the conversion is complete.

/k:PublicKeyToken

Specifies the custom public key token.

/h:remove

/h:update

Specifies whether to remove or update hint paths.

/o

Do not process subdirectories.

/ro

Skip read-only files.

/b

Do not create backup files.

/OmitTargetFrameworkValidation

Omits checking the target framework.

See Also