dotnet add reference

  • Статья

Эта статья относится к: ✔️ пакету SDK для .NET Core 3.1 и более поздних версий

name

dotnet add reference — добавляет перекрестные ссылки между проектами (P2P).

Краткий обзор

dotnet add [<PROJECT>] reference [-f|--framework <FRAMEWORK>]
     [--interactive] <PROJECT_REFERENCES>

dotnet add reference -h|--help

Описание

Команду dotnet add reference удобно использовать для добавления ссылок на проекты в проект. После запуска этой команды в файл проекта добавляются элементы <ProjectReference>.

<ItemGroup>
  <ProjectReference Include="app.csproj" />
  <ProjectReference Include="..\lib2\lib2.csproj" />
  <ProjectReference Include="..\lib1\lib1.csproj" />
</ItemGroup>

Добавление ссылки на сборку, которая отсутствует в проекте

Команда CLI для добавления ссылки на сборку, которой нет в проекте или пакете, отсутствует. Но это можно сделать, изменив CSPROJ-файл и добавив разметку, как в следующем примере:

<ItemGroup>
  <Reference Include="MyAssembly">
    <HintPath>.\MyDLLFolder\MyAssembly.dll</HintPath>
  </Reference>
</ItemGroup>

Аргументы

  • PROJECT

    Указывает файл проекта. Если он не указан, команда ищет текущий каталог для него.

  • PROJECT_REFERENCES

    Добавляемые перекрестные ссылки между проектами (P2P). Укажите один или несколько проектов. Стандартные маски поддерживаются в системах на основе Unix или Linux.

Параметры

  • -f|--framework <FRAMEWORK>

    Добавляет ссылки на проект только при ориентации на конкретную платформу в формате TFM.

  • -?|-h|--help

    Выводит описание использования команды.

  • --interactive

    Позволяет команде остановиться и дождаться, пока пользователь выполнит действие или введет данные. Например, чтобы завершить проверку подлинности. Доступно, начиная с пакета SDK для .NET Core 3.0.

Примеры

  • Добавление ссылки на проект:

    dotnet add app/app.csproj reference lib/lib.csproj

  • Добавление нескольких ссылок на проекты в проект в текущем каталоге:

    dotnet add reference lib1/lib1.csproj lib2/lib2.csproj

  • Добавление нескольких ссылок на проект с помощью стандартной маски в Linux/Unix:

    dotnet add app/app.csproj reference **/*.csproj