Converting your web project to a newer version of Visual Studio may result in this error when you try to open it after the migration: “The following Web projects must be converted to the new Web Site format”.
Here is the full error message:
The following Web projects must be converted to the new Web Site format. The conversion process will remove all source control bindings and the project will not be under source control after migration.
It may be followed by the message below.
Some of the properties associated with the solution could not be read.
The root cause of the problem is that the old Visual Studio project was migrated to “Web Application Project (WAP)” format while it was still bound to TFS. Presumably (not tested), this error shouldn’t have occurred if it was migrated to “Website Project” after unbinding from TFS.
Looking for a solution to fix “Declaration expected”, “Syntax error”, and “Statement cannot appear outside of a method” errors in Visual Studio? Check this post out.
Solution for “”The following Web projects must be converted to the new Web Site format” error
There a few approaches to take to solve this issue.
Approach 1:
- Open
vspsccfile (Project_Name.csproj.vspscc) - Change
ENLISTMENT_CHOICEtoNEVER - Remove the value of
ORIGINAL_PROJECT_FILE_PATHparameter
After the changes, it should look like this:
{
"ENLISTMENT_CHOICE" = "NEVER"
"ORIGINAL_PROJECT_FILE_PATH" = ""
}
After changing vspscc file, open your solution file (name.sln). Remove the line that has this parameter: SccProjectEnlistmentChoice.
Approach 2
- Remove all
vspsccfiles. TFS is supposed to re-generate these files with correct settings - Open your solution file (name.sln). Remove the lines that has this parameter:
SccProjectEnlistmentChoice
Approach 3
This approach may take more time but it’s a good opportunity for a clean start. It may actually save time if the first 2 approaches don’t solve the problem for some reason.
- Create a brand-new solution file with the new version of Visual Studio
- Copy your code manually to this solution
- Bind it to TFS
Additional Approaches
In this post, author suggests removing all GlobalSection blocks in the solution file except the one your project (the project that causes the error) uses. Then it recommends performing the steps I explained in the Approach 1 above.
In this Microsoft article, author suggests changing SCCServerPath value from relative path to absolute path in registry. This solution is specifically for the second error message in the beginning of this post (“Some of the properties associated with the solution could not be read”).
