Разработайте приложения с использованием Microsoft.NETFramework.ReferenceAssemblies

Если вы используете определенную версию .NET Framework, по умолчанию приложение создается с помощью эталонных сборок, включенных в пакет разработчика этой версии. В сценариях, когда соответствующий пакет разработчика не удается установить на компьютер, можно вместо этого выполнять сборку с использованием ссылочных сборок, предоставленных через пакет NuGet.

Обновление файлов проекта

Каждый проект, который должен создаваться на основе ссылочных сборок пакета NuGet, должен содержать ссылку на Microsoft.NETFramework.ReferenceAssemblies.

Проекты, использующие файл packages.config , должны содержать следующие элементы в packages.config.

<packages>
  <package id="Microsoft.NETFramework.ReferenceAssemblies" version="1.0.3" developmentDependency="true" />
</packages>

Проекты, использующие <PackageReference> свойство MSBuild, должны содержать следующее свойство в файле проекта.

<ItemGroup>
  <PackageReference Include="Microsoft.NETFramework.ReferenceAssemblies" Version="1.0.3" PrivateAssets="All" />
</ItemGroup>

Проекты в стиле SDK включают эту ссылку по умолчанию. Для типичных проектов .NET Framework, созданных с помощью Visual Studio, можно добавить ссылку с помощью пользовательского интерфейса Диспетчера пакетов NuGet в Visual Studio. Пакет содержит справочные сборки для многих версий .NET Framework. Фактически используемая версия определяется свойством TargetFrameworkVersion или TargetFramework, как уже определено в файле проекта.

Восстановление проекта

Проекты, содержащие ссылку на пакет, должны быть восстановлены перед сборкой.

После добавления пакета NuGet Microsoft.NETFramework.ReferenceAssemblies в проект необходимо явно выполнить действие восстановления одним из следующих способов:

• Если ваш проект не является проектом в стиле SDK и использует файл packages.config для ссылки на пакеты NuGet:

  1. Установите средство командной строки NuGet и убедитесь, чтоnuget.exe находится в переменной PATH среды.
  2. Откройте командную строку.
  3. Перейдите в каталог, содержащий файл проекта.
  4. Выполните nuget.exe restore.

• Если проект не является проектом в стиле SDK и использует <PackageReference> параметры в файле проекта для ссылки на пакеты NuGet:

  1. Откройте командную строку разработчика для VS 2022. Имя этого приложения может отличаться в зависимости от установленной версии Visual Studio.
  2. Перейдите в каталог, содержащий файл проекта.
  3. Выполните msbuild /t:restore.

• Если проект является проектом в стиле SDK, вам не нужно ничего делать. Действие восстановления NuGet выполняется автоматически при создании проекта.

Это важно

Использование ссылочных сборок позволяет создавать проекты, предназначенные для неподдерживаемых версий .NET Framework из командной строки. Однако вы по-прежнему не можете загрузить эти проекты в более новых версиях Visual Studio. Чтобы продолжить создание этих приложений в Visual Studio, единственным решением является использование более старой версии Visual Studio.