#Перевод WinForms-проекта на NetForms

WinForms-проект на Linux не собирается:

$ dotnet build
error NETSDK1100: To build a project targeting Windows on this operating system,
set the EnableWindowsTargeting property to true.

а если заставить (-p:EnableWindowsTargeting=true), собирается, но не запускается:

$ dotnet run -p:EnableWindowsTargeting=true
You must install or update .NET to run this application.
Framework: 'Microsoft.WindowsDesktop.App', version '10.0.0' (x64)
No frameworks were found.

Microsoft.WindowsDesktop.App — настоящий WinForms — существует только для Windows. NetForms заменяет его пакетом NuGet. В большинстве проектов меняется только файл .csproj.

#Конвертер

dotnet tool install -g NetForms.Convert --prerelease

netforms-convert MyApp.csproj              # анализ: что изменится и что не будет работать
netforms-convert MyApp.csproj --apply      # переписать проект
dotnet run

В VS Code: правый щелчок по .csproj → NetForms: Convert WinForms Project… — тот же анализ в виде отчёта со ссылками на файл и строку, затем та же правка.

Что он делает с проектом в SDK-формате:

 <Project Sdk="Microsoft.NET.Sdk">

   <PropertyGroup>
     <OutputType>WinExe</OutputType>
-    <TargetFramework>net8.0-windows</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <Nullable>enable</Nullable>
-    <UseWindowsForms>true</UseWindowsForms>
     <ImplicitUsings>enable</ImplicitUsings>
   </PropertyGroup>

+  <ItemGroup>
+    <PackageReference Include="NetForms" Version="0.1.0-preview.6" />
+    <!-- What <UseWindowsForms>true</UseWindowsForms> added: the WinForms namespaces as implicit usings. -->
+    <Using Include="System.Drawing" />
+    <Using Include="System.Windows.Forms" />
+  </ItemGroup>
+
 </Project>

Исходный файл сохраняется как MyApp.csproj.winforms.bak. Повторный запуск ничего не меняет.

Параметры:

Аргументом может быть проект, решение (.sln, .slnx) или папка.

#Проекты .NET Framework

Проекты старого формата (<Project ToolsVersion="15.0" …>, packages.config, список <Compile Include>) конвертер сам переводит в SDK-формат:

• список файлов → шаблоны (globs), с Remove для файлов на диске, которые старый проект не компилировал, и Update для DependentUpon и генераторов;
• переносятся OutputType, RootNamespace, AssemblyName, ApplicationIcon, StartupObject, LangVersion, AllowUnsafeBlocks, подпись .snk; Properties\AssemblyInfo.cs остаётся (GenerateAssemblyInfo=false);
• ссылки на сборки фреймворка убираются (в .NET они неявны), ссылки с HintPath остаются, packages.config → PackageReference, ссылки на проекты сохраняются;
• файлы, которые программа читала из закоммиченной папки bin\Debug, получают CopyToOutputDirectory;
• библиотеки того же решения без WinForms становятся библиотеками net10.0.

Исходники правятся только там, где правка не может изменить смысл: удаляется using пространства имён, которого в .NET нет (System.Runtime.Remoting.Messaging); для типа, переехавшего в .NET в NuGet-пакет (System.Data.SqlClient, System.IO.Ports), добавляется PackageReference; ссылки на файлы в .resx приводятся к реальному регистру букв.

#Вручную

1. TargetFramework: net10.0 (или net10.0-windows — только для Windows).
2. Удалите <UseWindowsForms>true</UseWindowsForms> (и <EnableWindowsTargeting>, если добавляли).
3. Добавьте <PackageReference Include="NetForms" Version="0.1.0-preview.6" />.
4. Если включён ImplicitUsings, добавьте <Using Include="System.Drawing" /> и <Using Include="System.Windows.Forms" />.

#Что может сказать отчёт

#Неполадки

Исправить страницу на GitHub