dotnet reference add

本文適用於： ✔️ .NET Core 3.1 SDK 與更新版本

名稱

dotnet reference add - 新增專案對專案 （P2P） 參考。

備註

如果您使用 .NET 9 SDK 或更早版本，請改用 “verb first” 窗體 （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） 參考。 指定一或多個專案。 Unix/Linux 系統上支援 Glob 模式。

選項

• -f|--framework <FRAMEWORK>

  只有在使用 TFM 格式以特定 架構為目標時， 才會新增項目參考。

• -?|-h|--help

  輸出有關如何使用命令的說明。

• --interactive

  可讓命令停止，並等候使用者輸入或進行動作。 例如完成驗證。 自 .NET Core 3.0 SDK 起提供使用。

範例

• 新增項目參考：

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

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