115

I have a solution in Visual Studio 2012 with 170 C# projects in it. I need to retarget all of the projects from .NET Framework 4.0 to 4.5.2.

I prefer to let Visual Studio handle this by going into the properties of each project, changing the targeted framework, and letting Visual Studio make any necessary changes to the .csproj files.

I noticed that these changes include adding a few new XML tags to the .csproj, depending on some attributes of the current project.

How can I batch retarget all 170 C# projects without just using a replace text tool to replace the targeted version number? I want Visual Studio to make all the necessary tag modifications and additions and replace alone will not permit that to happen.

5
  • I don't know of any way to do this automatically.. I think your best bet would be a standard windows macro recorder, which you use keyboard commands.. But, I would execute these one at a time rather than try to batch them together since it may be difficult to identify when VS is done with its work in all cases. Commented Feb 10, 2015 at 16:05
  • 2
    No, you should not be doing this. Especially not 4.5.2, it has no useful new types and is unlikely to be covered by future multi-targeting packs. Just like 4.0x wasn't. Do this one project at a time and only the ones that need it. The ones where you actually want to add a new reference assembly and modify the code to use them. If you want to ignore this advice, you probably do, then use Edit > Find and Replace > Replace in Files to replace the TargetFrameworkVersion element in the *.csproj files. Make sure your source control is solid. Commented Feb 10, 2015 at 16:11
  • 2
    @HansPassant Your solution of Find/Replace is exactly what I didn't want to do according to my question. I need a more robust solution.
    – Kyle V.
    Commented Feb 10, 2015 at 16:20
  • @GrantWinney I /know/ it won't work because I already tried Find/Replace and if you use that method then the additional .csproj changes that Visual Studio would have done otherwise are not implemented.
    – Kyle V.
    Commented Feb 10, 2015 at 16:31
  • 1
    @GrantWinney the Target Framework Migrator extension does exactly what I wanted. If you can create an answer I will mark it correct. Thanks!
    – Kyle V.
    Commented Feb 10, 2015 at 16:58

6 Answers 6

101

The MSDN documentation "Migration Guide to the .NET Framework 4.5" and "How to Configure an App to Support .NET Framework 4 or 4.5" only discusses modifying projects. There's no details on applying changes to the entire solution at once, nor have I seen a function in VS that supports it.

However, there's a (well-rated) extension called Target Framework Migrator available in the Visual Studio gallery, which supports upgrading to 4.5.2 (as well as newer versions**) and looks like it'll do exactly what you want. The source code is available on GitHub, if you're interested.

Note that the lack of such a feature may be intentional (and not just an omission). I'm just guessing, but maybe MS figures only projects that need the new Frameworks will be upgraded. FWIW, if you end up upgrading some projects that are shared with other solutions, those solutions may fail to build until they're upgraded too.

That being said, if you're in a small shop with just one (or a few) solutions and you're looking to upgrade everything in one go, then perhaps the above tool will work for you.


There's been no development on this for years, and apparently the developer has no plans to pass the baton to anyone else.

If you're unable to get it to work with a newer .NET Framework version, check the existing PRs and Issues for fixes, but you may have to apply them yourself. For example, someone posted a fix for .NET Framework v 4.7.1. Hopefully these will get merged, but I wouldn't hold my breath.

If anyone else is seeing the same error as Anas (in the comments), here's a GitHub issue from a couple weeks ago, and another possibly related issue from 2017. Consider thumbs upping them and adding more details if you're having the same problem.

9
  • 7
    The "target framework migrator" tool is failing on latest VS 2017 update 15.5.5 , "Invalid parameter" Commented Feb 8, 2018 at 8:28
  • 1
    Worked for me today with VS2017 15.7 to Framework 4.7
    – Tod
    Commented May 8, 2018 at 14:50
  • 1
    I very much doubt that MS would intentionally omit features for users benefit... much more likely it is just something else they didn't think about or don't have to support... pass it on to the community..
    – PJUK
    Commented May 29, 2018 at 13:09
  • 1
    @Grant I added a comment to the existing issue. I actually did the job with a find/sed search and replace in the project and config files.
    – JB.
    Commented Sep 24, 2018 at 15:22
  • 2
    The developer passed the baton on december 2019, you can edit your (good) answer again :) Commented Feb 4, 2020 at 15:55
20

For a .NET Framework solution, a simple "Replace in files" did the trick for me:

eg: From .NET Framework 4.5.2 to .NET Framework 4.7.2

In package.config files, replace all

targetFramework="net452" 

to

targetFramework="net472" 

In *.csproj files, replace all

<TargetFrameworkVersion>v4.5.2</TargetFrameworkVersion> 

to

<TargetFrameworkVersion>v4.7.2</TargetFrameworkVersion>
3
  • 1
    In VS 2019, "replace all" doesn't quite work. You have to repeatedly use "find next." This is my last Microsoft based development project. I am moving over to MacOSX where there's consistency and a decent level of QA performed on their products.
    – ATL_DEV
    Commented Jan 11, 2020 at 16:36
  • 2
    Changing the targetFramework in packages.config doesn't reinstall the package for that framework, so you could still end up with the wrong version. You'd have to reinstall the package, or at least delete your packages folder and restore the right version of the package. The problem is with that old packages.config model, without reinstalling, you're dll references for the package will be targeting the wrong dll in the wrong subdirectory of the package.
    – Triynko
    Commented Jan 17, 2020 at 2:41
  • 3
    Wow, ended up right back at this question again after vacation and also saw a need to comment on this same answer, haha. I will add that the *.csproj and packages.config files are not the only things that reference the target framework. There are also references in web.config files in various sections. For example, under system.web, the compilation and httpRuntime tags have a targetFramework attribute that would need updated. So, this 'find and replace' manual process seems like a really terrible idea that could leave your projects in inconsistent and corrupt state.
    – Triynko
    Commented Jan 29, 2020 at 19:16
11

Since the Target Framework Migrator is broken, I rolled my own search/replace (using git bash, it works ok on windows) ; Basically it changes the v4.6.x into v4.7.2, then it converts back the files to using the infamous DOS's CRLF :

find . \( -iname '*.csproj' -o -iname '*.vcxproj' -o -iname 'app.config' \) \
 -exec grep -Z -l 'v4\.6\..' \{} \; | xargs -0 sed -i 's/v4\.6\../v4.7.2/'  
find . \( -iname '*.csproj' -o -iname '*.vcxproj' -o -iname 'app.config' \) \
 -exec grep -Z -l 'v4\.7\..' \{} \; | xargs -0 unix2dos
3
  • 5
    I found this, and then a Update-Package -ReInstall do wonders. Thanks!
    – askrich
    Commented Oct 8, 2018 at 12:28
  • 1
    This worked perfectly fine for me. Thank you for this solution
    – Maryam
    Commented Jan 7, 2019 at 6:29
  • For a powershell version see stackoverflow.com/a/2837891/463425
    – tkerwood
    Commented Feb 19, 2020 at 1:17
7

I have built myself a simple tool to migrate the target framework versions for an entire solution, because the Target Framework Migrator Extension does not support Visual Studio 2017. Download the tool from my GitHub repository https://github.com/Xpitfire/TargetFrameworkMigrator

I know this is not the best way to go, but it worked for me and maybe it will also help someone else.

2
  • It does now for sure. Commented Oct 2, 2017 at 10:28
  • 2
    The irony of this being built in Java. 🤣
    – Webreaper
    Commented Jul 22, 2021 at 16:47
4

Target Framework Migrator is pretty useful. By default, it comes up to v4.7. However, it's easy to add support for v4.7.1, v4.7.2 and v4.8.

Find Frameworks.xml file in C:\Users{username}\AppData\Local\Microsoft\VisualStudio\ folder and edit by adding these framework versions:

<Framework Id="262152" Name=".NETFramework,Version=v4.8"/>
<Framework Id="262663" Name=".NETFramework,Version=v4.7.2"/>
<Framework Id="262407" Name=".NETFramework,Version=v4.7.1"/>

After you restart visual studio, you will see new versions.

3
2
public void ChangeFramework() {

  //Add Reference to envdte (Assemblies\Extensions\envDTE)
  string SolutionFile = @"C:\MyProject\MyProject.sln";
  string ProjectName = "MyProject";

  //------------------------------------------------------------------------
  //Find the Program ID from the registry for VisualStudio.DTE
  //Look it up In Registry: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Classes
  System.Type oType = System.Type.GetTypeFromProgID("VisualStudio.DTE", true);
  EnvDTE.DTE dte = (EnvDTE.DTE)Activator.CreateInstance(oType, true);

  //------------------------------------------------------------------------
  //Open your Solution
  dte.Solution.Open(SolutionFile);

  //------------------------------------------------------------------------
  //Now In your solution go through what is listed in dte.Solution.Projects 
  //and find the one that match what you want to change target for
  int iItemsCount = dte.Solution.Projects.Count;
  string sCurrent = "";

  for (int i = 1; i <= iItemsCount; i++) {

    sCurrent = dte.Solution.Projects.Item(i).Name;

    if (dte.Solution.Projects.Item(i).Name == ProjectName) {
      //Once you find your project, Change the Framework
      EnvDTE.Project oProject = dte.Solution.Projects.Item(i);
      oProject.Properties.Item("TargetFrameworkMoniker").Value = ".NETFramework,Version = v4.6.2";
    }
  }

  //------------------------------------------------------------------------
  //Close your Solution
  dte.Solution.Close();
}

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.