Export (0) Print
Expand All
2 out of 37 rated this helpful - Rate this topic

Visual Studio Conversion Wizard

Use this wizard to convert your solution or project to the project file format that is used by this version of Visual Studio. The converted solution or project will be created in the same location as the current solution or project and a backup copy can be created before conversion. All projects in a solution are converted.

To access this wizard, select Open on the File menu, and then click Project/Solution, Web Site, or File and select one of the following file types: .vcproj, .csproj, .vbproj, .vjsproj, or .sln.

Converting Solutions or Projects

Solutions or projects that were created in or upgraded to Visual Studio .NET 2002 or Visual Studio .NET 2003 must be converted to the format that is used by this version of Visual Studio before you can work with them in this version of Visual Studio. Converted solutions or projects are no longer compatible with Visual Studio .NET 2002 or Visual Studio .NET 2003.

When a solution is converted, all projects in the solution are converted. If any project cannot be converted, that project is unloaded and marked as unavailable in Solution Explorer. In this situation, address the problems indicated in the upgrade report as you attempt to reload the projects that are marked (unavailable). When you attempt to reload projects, this wizard starts again. For information about the errors that could occur, see Upgrade Report at the end of this topic.

Converting Source-Controlled Solutions or Projects

If you are converting a source-controlled solution or project, it will be checked out automatically during the conversion. Be sure that no files are exclusively checked out by another user because the projects that contain those files will not be converted.

Batch Conversion of Solutions or Projects

To automate the conversion of many solutions or projects, you can create a batch file that uses the command line upgrade tools. For more information, see /Upgrade (devenv.exe). The upgrade report provides information about source-controlled solutions or projects that were not converted because files were checked out. After those files have been checked in, you can run the batch file again to convert those solutions or projects.

Web Projects

Visual Web Developer manages Web sites (projects) and files differently than Visual Studio .NET 2002 and Visual Studio .NET 2003 do. For information about conversion of Web projects, see Web Project Conversion from Visual Studio .NET.

Converting to Visual Studio 2005 from Versions of Visual Studio Earlier than Visual Studio .NET 2002

Visual Basic 6.0 projects can be converted directly to the project file format that is used by this version of Visual Studio. For more information, see Upgrading Applications Created in Previous Versions of Visual Basic.

Visual C++ 6.0, 5.0, and 4.0 projects can be converted directly to the project file format that is used by this version of Visual Studio by using this wizard. For information about working with converted projects, see How to: Upgrade Wizard-Generated Managed Extensions for C++ Code.

Visual J++ 6.0 projects can be converted directly to Visual J# projects in the project file format that is used by this version of Visual Studio. For more information, see Visual J# Upgrade Wizard.

Welcome Page

This page introduces you to the Visual Studio Conversion Wizard.

Choose Whether to Create a Backup Page

On this page, you specify whether a copy of your solution or project in its current format is made before the solution or project is converted. We recommend that you create a backup if the solution or project is not source controlled or if you want to be able to open the solution or project in your earlier version of Visual Studio.

For some solutions and projects, you can specify the backup location; for others, the backup files are created in the same folder as the files that are being converted:

Project type Backup options

Visual Basic

You can specify the backup location for Visual Basic projects and for solutions that contain Visual Basic projects with any combination of Visual C#, Visual J#, or Web projects.

Backup files are created in the same folder as the files that are being converted for solutions that contain both Visual C++ projects and Visual Basic projects.

In solutions that contain Visual Basic projects and both Web projects and Visual C++ projects, only the Web projects can be backed up.

Visual C#

You can specify the backup location for Visual C# projects and for solutions that contain Visual C# projects with any combination of Visual Basic, Visual J#, or Web projects.

Backup files are created in the same folder as the files that are being converted for solutions that contain both Visual C++ projects and Visual C# projects.

In solutions that contain Visual C# projects and both Web projects and Visual C++ projects, only the Web projects can be backed up.

Visual J#

You can specify the backup location for Visual J# projects and for solutions that contain Visual J# projects with any combination of Visual Basic, Visual C#, or Web projects.

Backup files are created in the same folder as the files that are being converted for solutions that contain both Visual C++ projects and Visual J# projects.

In solutions that contain Visual J# projects and both Web projects and Visual C++ projects, only the Web projects can be backed up.

Web

You can specify the backup location for Web projects and for solutions that contain Web projects with any combination of Visual Basic, Visual C#, or Visual J# projects.

Only the Web projects can be backed up in solutions that contain both Web projects and Visual C++ projects or Web projects, Visual C++ projects and any combination of these project types: Visual Basic, Visual C#, and Visual J#. You can specify the backup location.

Visual C++

Backup files are created in the same folder as the files that are being converted for Visual C++ projects and for solutions that contain both a Visual C++ project and one or more of the following project types: Visual Basic, Visual C#, and Visual J#.

In solutions that contain both Web projects and Visual C++ projects or Web projects, Visual C++ projects and any combination of Visual Basic, Visual C#, and Visual J# projects, only the Web projects can be backed up.

Do you want to create a backup before converting?

No

Specifies that a backup is not created. You will not be able to work with the solution or project again in Visual Studio .NET 2002 or Visual Studio .NET 2003.

Yes, create a backup before converting

Specifies that a backup is created. Specify the Location for backup if you are converting one of the following project types or a solution that contains any combination of these project types: Visual Basic, Visual C#, Visual J#, and Web.

- or -

Yes, create a backup of all Web projects

Specifies that a backup is created. Specify the Location for backup for the Web projects if you are converting a solution that contains both Web projects and Visual C++ projects or Web projects, Visual C++ projects and any combination of these project types: Visual Basic, Visual C#, and Visual J#.

Location for backup

Specifies the location of the backup files. The location can be a folder on your computer or a UNC path but not a URL.

Browse

Displays the Select backup folder dialog box, which allows you to navigate to the folder where you want to locate the backup files.

Ready to Upgrade Page

On this page, you review a summary of the conversion options that you have selected and then start the conversion.

Confirm that the solution and all projects are listed and that, if you specified a backup location, it is correct. All converted solutions or projects will be created in the same location as the current solution or project (in-place conversion).

To change the conversion information, click Back to return to the Choose Whether to Create a Backup page.

Conversion Complete Page

On this page, you are informed whether the conversion completed successfully. If one or more projects failed to convert, those projects are unloaded and marked (unavailable) in Solution Explorer. For information about the status of each file, click the link to display the upgrade report.

Upgrade Report

The upgrade report provides information about the status of each file in the solution or project after conversion and is located in the root directory for the solution or project.

If any project cannot be converted, that project is unloaded and marked (unavailable) in Solution Explorer. In this situation, address the problems indicated in the upgrade report as you attempt to reload the projects that are marked (unavailable). When you attempt to reload projects, this wizard starts again. The errors that could occur are described here.

Error creating backup file

A backup copy of the solution file cannot be created. Check whether there is already a file with the same name.

Error creating backup of project file

A backup copy of the project file cannot be created. Check whether there is already a file with the same name.

File is not writable

The file is read-only or is located on a read-only network share. Source-controlled files that are exclusively checked out by another user are read-only.

Internal Non Fatal Error

An error has occurred with Visual Studio. To attempt to repair Visual Studio, using the Add or Remove Programs dialog box, choose the product you have installed, and then choose Change/Remove.

Unable to open project file to perform upgrade

The project file cannot be opened. Check whether the project file has been opened and locked by another application.

Unable to parse project file

The project file is corrupt or a version that cannot be upgraded.

Unable to save upgraded project file

An internal error may have occurred.

Web project component not installed. Unable to upgrade project

The project is a Web project. Visual Web Developer Express edition is the only Express edition that can be used to convert Web projects.

See Also

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.