dotnet add reference

Статья
05/10/2023

Эта статья относится к: ✔️ пакету 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
```

Поделиться через