手把手教会将 Windows 窗体桌面应用从.NET Framework迁移到 .NET SDK/.NET 6 格式

本文介绍如何将 Windows 窗体桌面应用从 .NET Framework 迁移到 .NET SDK 格式或 .NET 6 或更高版本。 .NET SDK 支持 Windows 窗体应用程序。 Windows 窗体仍是仅适用于 Windows 的框架，并且只能在 Windows 上运行。 将应用从 .NET Framework 迁移到 .NET SDK 格式或 .NET 6 通常需要一个新的项目文件。 NET 6 使用 SDK 样式的项目文件，而 .NET Framework 通常使用较旧的 Visual Studio 项目文件。 如果你曾经在文本编辑器中打开过 Visual Studio 项目文件，你就会知道它有多么详细。 SDK 样式的项目较小，不需要像旧版项目文件格式那样多的条目。

接上篇:手把手教会 VS2022 设计 Winform 高DPI兼容程序 (net461 net6.0 双出) https://www.cnblogs.com/densen2014/p/16142939.html

本文介绍如何将 Windows 窗体桌面应用从 .NET Framework 迁移到 .NET SDK 格式或 .NET 6 或更高版本。 .NET SDK 支持 Windows 窗体应用程序。 Windows 窗体仍是仅适用于 Windows 的框架，并且只能在 Windows 上运行。

将应用从 .NET Framework 迁移到 .NET SDK 格式或 .NET 6 通常需要一个新的项目文件。 NET 6 使用 SDK 样式的项目文件，而 .NET Framework 通常使用较旧的 Visual Studio 项目文件。 如果你曾经在文本编辑器中打开过 Visual Studio 项目文件，你就会知道它有多么详细。 SDK 样式的项目较小，不需要像旧版项目文件格式那样多的条目。

备份项目

迁移项目的第一步是备份项目！ 如果出现问题，可以通过还原备份将代码还原为其原始状态。 不要依赖于 .NET 可移植性分析器等工具来备份项目，即使它们似乎可以完成备份。 最好是亲自创建原始项目的副本。

卸载工程,编辑项目文件

剪切所有内容到记事本.添加空白项目文件

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <!-- 选一种自己需要的方式 -->
    <TargetFramework>net6.0-windows</TargetFramework>
    <TargetFramework>net461</TargetFramework> 
    <TargetFrameworks>net6.0-windows;net461;</TargetFrameworks> 
    <!-- 如果是库,这句直接删除,库不需要定义 <OutputType> 设置-->
    <OutputType>WinExe</OutputType> 
    <GenerateAssemblyInfo>false</GenerateAssemblyInfo>
    <UseWindowsForms>true</UseWindowsForms>
  </PropertyGroup>
</Project>

<RootNamespace>FreeRes2019</RootNamespace>
<AssemblyName>FreeRes2019</AssemblyName>

节点

所有的 <PropertyGroup>单独节点内容 直接全部复制到新项目 <PropertyGroup> 下面

例如

<PropertyGroup>
  <RootNamespace>Freexxx2019</RootNamespace>
  <AssemblyName>Freexxx2019</AssemblyName>
</PropertyGroup>
<PropertyGroup>
  <GenerateManifests>false</GenerateManifests>
</PropertyGroup>

复制到

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <!-- 选一种自己需要的方式 -->
    <TargetFramework>net6.0-windows</TargetFramework>
    <TargetFramework>net461</TargetFramework> 
    <TargetFrameworks>net6.0-windows;net461;</TargetFrameworks> 
    <!-- 如果是库,这句直接删除,库不需要定义 <OutputType> 设置-->
    <OutputType>WinExe</OutputType> 
    <GenerateAssemblyInfo>false</GenerateAssemblyInfo>
    <UseWindowsForms>true</UseWindowsForms>
    <!-- 复制到这里 -->
    <RootNamespace>Freexxx2019</RootNamespace>
    <AssemblyName>Freexxx2019</AssemblyName>
    <GenerateManifests>false</GenerateManifests>
  </PropertyGroup>
</Project>

引用升级

对于这种直接复制到新项目文件即可

    <Content Include="TSCLIB.dll">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </Content>

Reference Include 升级

  <ItemGroup>
    <Reference Include="System" />
    <Reference Include="System.Core" />
    <Reference Include="System.Xml.Linq" />
    <Reference Include="System.Data.DataSetExtensions" />
    <Reference Include="Microsoft.CSharp" />
    <Reference Include="System.Data" />
    <Reference Include="System.Net.Http" />
    <Reference Include="System.Xml" />
  </ItemGroup>

新版

<ItemGroup>
    <Import Include="System" />
    <Import Include="System.Core" />
    <Import Include="System.Xml.Linq" />
    <Import Include="System.Data.DataSetExtensions" />
    <Import Include="Microsoft.CSharp" />
    <Import Include="System.Data" />
    <Import Include="System.Net.Http" />
    <Import Include="System.Xml" />
</ItemGroup>

工程引用

删除 Project 和 Name节点复制过去

  <ItemGroup>
    <ProjectReference Include="..\AME.FreeRes\AME.FreeRes.csproj">
      <Project>{bd216839-c870-4b5a-b3e3-46bd5f7d8d6d}</Project>
      <Name>AME.FreeRes</Name>
    </ProjectReference>
  </ItemGroup>

复制为

  <ItemGroup>
    <ProjectReference Include="..\AME.FreeRes\AME.FreeRes.csproj" /> 
  </ItemGroup>

Compile 一般不需要复制

  <ItemGroup>
    <Compile Include="Attribute\Attribute.cs" />
    <Compile Include="DataTableBase.cs" />
    ...
</ItemGroup>

NuGet 包

如果项目引用了 NuGet 包，则项目文件夹中可能包含 packages.config 文件。 对于 SDK 样式的项目，NuGet 包引用是在项目文件中配置的。 Visual Studio 项目文件也可以选择在项目文件中定义 NuGet 包。 .NET 6 不会将 packages.config 用于 NuGet 包。 在迁移之前，必须将 NuGet 包引用迁移到项目文件中。

  <ItemGroup>
    <PackageReference Include="Newtonsoft.Json">
      <Version>13.0.1</Version>
    </PackageReference>
  </ItemGroup>

改为

  <ItemGroup>
    <PackageReference Include="Newtonsoft.Json"  Version="13.0.1" />
  </ItemGroup>

要迁移 packages.config 文件，请执行以下步骤：

1. 在“解决方案资源管理器”中，找到要迁移的项目。
2. 右键单击“packages.config”>“将 packages.config 迁移到 PackageReference”。
3. 选择所有顶级包。
4. 系统会生成一个生成报告，让你知道与迁移 NuGet 包有关的任何问题。

库不需要定义 设置。 如果要升级库项目，请删除该条目。

重载项目

将项目转换为新的 SDK 样式格式后，请在 Visual Studio 中重载项目：

在“解决方案资源管理器”中，找到要转换的项目。

右键单击项目，选择“重载项目”。

如果项目加载失败，则可能是因为在项目的 XML 中引入了一个错误。 打开项目文件以进行编辑，并尝试识别和修复错误。 如果找不到错误，请尝试重启。

编辑 App.config

如果你的应用包含 app.config 文件，则删除 元素：

<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />

对于 App.config 文件，有一些事项需要考虑。 .NET Framework 中的 App.config 文件不仅用于配置应用，还用于配置运行时设置和行为，如日志记录。 .NET 6（和 .NET Core）中的 App.config 文件不再用于运行时配置。 如果 App.config 文件包含这些部分，则不会考虑这些部分。

实际项目

升级完成后，迁移的 Windows 窗体项目将类似于以下 XML：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <!-- 选一种自己需要的方式 -->
    <TargetFramework>net6.0-windows</TargetFramework>
    <TargetFramework>net461</TargetFramework> 
    <TargetFrameworks>net6.0-windows;net461;</TargetFrameworks> 
    <!-- 如果是库,这句直接删除,库不需要定义 <OutputType> 设置-->
    <OutputType>WinExe</OutputType> 
    <GenerateAssemblyInfo>false</GenerateAssemblyInfo>
    <UseWindowsForms>true</UseWindowsForms>
  </PropertyGroup>
  <ItemGroup>
    <ProjectReference Include="..\MatchingGame.Logic\MatchingGame.Logic.csproj" />
  </ItemGroup>
  <ItemGroup>
    <PackageReference Include="MetroFramework" Version="1.2.0.3" />
    <PackageReference Include="Microsoft.DotNet.UpgradeAssistant.Extensions.Default.Analyzers" Version="0.3.261602">
      <PrivateAssets>all</PrivateAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.Windows.Compatibility" Version="6.0.0" />
  </ItemGroup>
</Project>

我自己的工程,升级项目文件后后,精简了不少

参考资料

https://docs.microsoft.com/zh-cn/dotnet/core/porting/upgrade-assistant-winforms-framework
https://docs.microsoft.com/zh-cn/dotnet/desktop/winforms/migration/?view=netdesktop-6.0

原文链接

https://www.cnblogs.com/densen2014/p/16158137.html