dotnet reference add

2025-04-03

Tento článek se vztahuje na: ✔️ .NET Core 3.1 SDK a novější verze

Název

dotnet reference add – přidá odkazy typu project-to-project (P2P).

Poznámka:

Pokud používáte sadu .NET 9 SDK nebo starší, použijte místo toho "sloveso first" (dotnet add reference). Ve verzi .NET 10 byl zaveden formulář "první podstatné jméno". Další informace naleznete v tématu Konzistentnější pořadí příkazů.

Přehled

dotnet reference add reference [-f|--framework <FRAMEWORK>]
     [--interactive] <PROJECT_REFERENCES> [--project <PROJECT>]

dotnet reference add -h|--help

Popis

Příkaz dotnet reference add nabízí pohodlnou možnost přidání odkazů na projekt do projektu. Po spuštění příkazu se do souboru projektu přidají prvky <ProjectReference>.

<ItemGroup>
  <ProjectReference Include="app.csproj" />
  <ProjectReference Include="..\lib2\lib2.csproj" />
  <ProjectReference Include="..\lib1\lib1.csproj" />
  <ProjectReference Include="..\lib3\lib3.fsproj" />
</ItemGroup>

Přidání odkazu na sestavení, které není v projektu

Neexistuje žádný příkaz rozhraní příkazového řádku pro přidání odkazu na sestavení, které není v projektu nebo balíčku. Můžete to ale udělat úpravou souboru .csproj a přidáním značek podobných následujícímu příkladu:

<ItemGroup>
  <Reference Include="MyAssembly">
    <HintPath>.\MyDLLFolder\MyAssembly.dll</HintPath>
  </Reference>
</ItemGroup>

Argumenty

PROJECT

Určuje soubor projektu. Pokud není zadaný, příkaz vyhledá aktuální adresář.
PROJECT_REFERENCES

Odkazy na projekt-projekt (P2P) pro přidání Zadejte jeden nebo více projektů. globové vzory jsou podporovány v systémech Unix/Linux.

Možnosti

-f|--framework <FRAMEWORK>

Přidá odkazy na projekty pouze při cílení na konkrétní architekturu pomocí formátu TFM.

-?|-h|--help

Vytiskne popis použití příkazu.

--interactive

Umožňuje příkazu zastavit a čekat na uživatelský vstup nebo akci. Například k dokončení ověřování. K dispozici od sady .NET Core 3.0 SDK.

Příklady

Přidání odkazu na projekt:

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

Přidejte kompatibilní odkaz na projekt .NET (například F#), který funguje v obou směrech:
```
dotnet add app/app.csproj reference lib/lib.fsproj
```
Přidejte do projektu v aktuálním adresáři více odkazů na projekt:
```
dotnet reference add lib1/lib1.csproj lib2/lib2.csproj
```
Přidání více odkazů na projekt pomocí vzoru globbingu v systémech Linux/Unix:
```
dotnet reference add **/*.csproj --project app/app.csproj
```

Sdílet prostřednictvím