Share via


Upgrading Projects Created in Earlier Versions of LightSwitch

Projects that were created in an earlier version of LightSwitch use a different file structure, and you must upgrade them before you can open them in the current version of Visual Studio. After you upgrade them, you can no longer open them in the earlier version. You can open most projects after the upgrade without modifying them further. In some cases, you might need to make minor modifications after you upgrade. These exceptions will be noted in a conversion report.

Note

If you’ve installed Microsoft LightSwitch for Visual Studio Update 2, an additional project upgrade is performed when you add an HTML client to a solution. See Projects: The Container for Your Application.

Preparing to Upgrade

You may need to perform several tasks before you upgrade a LightSwitch project. First, you should make sure that you can open and successfully build the project in the earlier version of LightSwitch. If the project has errors, the upgrade is likely to fail.

If the project uses extensions, they must already be installed on the computer where you are performing the upgrade or the upgrade will fail. This requirement includes any extensions that the project references but doesn't use; you should remove any unused extensions before you upgrade. For more information, see How to: Add or Remove Extensions.

Upgrading a Project

When you try to open a project that was created in an earlier version of LightSwitch, the Review Project and Solution Changes dialog box appears. If your solution contains additional projects, you can view their status by choosing the Show additional projects link.

After you choose the OK button, the project files will be converted to the new format, and the project will appear in Solution Explorer. A backup copy of the original project will be saved in a Backup folder under the Solution folder. In addition, an UpgradeLog file will be created in the Solution folder. This file contains information about the changes that were made and any further modifications that you may need to perform.

Note

A copy of the original ApplicationDefinition.lsml file is saved in the Data folder. The upgraded project doesn't use this file, and it may be deleted.

After You Upgrade

After the upgrade is complete, open the UpgradeLog file, and review it for any errors.

If your project contained code in the Single or SingleOrDefault query interception methods, an error message will state that the method has been deprecated. You can usually resolve these errors by moving the code to the corresponding Execute, Executing, or ExecuteFailed methods. You can move code in the PreprocessQuery method to the new Filter method.

See Also

Tasks

How to: Handle Data Events

Concepts

How to: Add or Remove Extensions

Performing Data-Related Tasks by Using Code