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" />
  <ProjectReference Include="..\lib3\lib3.fsproj" />
</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
    
  • 添加兼容的 .NET 语言(例如 F#)项目引用,该引用适用于两个方向:

    dotnet add app/app.csproj reference lib/lib.fsproj
    
  • 将多个项目引用添加到当前目录中的项目:

    dotnet add reference lib1/lib1.csproj lib2/lib2.csproj
    
  • 在 Linux/Unix 上使用一个引爆模式添加多个项目引用:

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