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


Добавление ссылки dotnet

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

Имя

dotnet reference add. Добавляет ссылки на проект в проект (P2P).

Примечание.

Если вы используете пакет SDK для .NET 9 или более ранних версий, используйте вместо него формуdotnet add reference "глагол первой". В .NET 10 появилась форма "существительное первое". Дополнительные сведения см. в разделе "Более согласованный порядок команд".

Синопсис

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

dotnet reference add -h|--help

Описание

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

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

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

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

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

Аргументы

  • PROJECT

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

  • PROJECT_REFERENCES

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

Опции

  • -f|--framework <FRAMEWORK>

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

  • -?|-h|--help

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

  • --interactive

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

Примеры

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

    dotnet reference add lib/lib.csproj --project app/app.csproj
    
  • Добавьте совместимый справочник по проекту .NET (например, F#), который работает в обоих направлениях:

    dotnet add app/app.csproj reference lib/lib.fsproj
    
  • Добавьте несколько ссылок на проект в текущем каталоге:

    dotnet reference add lib1/lib1.csproj lib2/lib2.csproj
    
  • Добавьте несколько ссылок на проекты с помощью шаблона глоббинга в Linux или Unix:

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