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 上使用 Globbing 模式新增多個項目參考：

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