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
    
  • 在 Linux/Unix 上使用 Glob 模式新增多個專案參考:

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