dotnet add reference

本文适用于： ✔️ .NET Core 3.1 SDK 及更高版本

“属性”

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 的系统支持 glob 模式。

选项

• -f|--framework <FRAMEWORK>

  仅在以特定框架为目标时使用 TFM 格式添加项目引用。

• -?|-h|--help

  打印出有关如何使用命令的说明。

• --interactive

  允许命令停止并等待用户输入或操作。 例如，完成身份验证。 自 .NET Core 3.0 SDK 起可用。

示例

• 添加项目引用：

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

• 向当前目录中的项目添加多个项目引用：

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

• 使用 glob 模式在 Linux/Unix 上添加多个项目引用：

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