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