dotnet-referenstillägg

2025-04-03

Den här artikeln gäller för: ✔️ .NET Core 3.1 SDK och senare versioner

Namn

dotnet reference add – Lägger till P2P-referenser (project-to-project).

Anmärkning

Om du använder .NET 9 SDK eller tidigare använder du formuläret "verb first" (dotnet add reference) i stället. Formuläret "substantiv först" introducerades i .NET 10. Mer information finns i Mer konsekvent kommandoordning.

Sammanfattning

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

dotnet reference add -h|--help

Beskrivning

Kommandot dotnet reference add är ett praktiskt alternativ för att lägga till projektreferenser i ett projekt. När kommandot har körts läggs de <ProjectReference> elementen till i projektfilen.

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

Lägga till en referens till en sammansättning som inte finns i ett projekt

Det finns inget CLI-kommando för att lägga till en referens till en sammansättning som inte finns i ett projekt eller ett paket. Men du kan göra det genom att redigera din .csproj- fil och lägga till markering som liknar följande exempel:

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

Argumentpunkter

PROJECT

Anger projektfilen. Om det inte anges söker kommandot i den aktuella katalogen efter en.
PROJECT_REFERENCES

P2P-referenser (Project-to-Project) som ska läggas till. Ange ett eller flera projekt. Glob-mönster stöds på Unix-/Linux-baserade system.

Alternativ

-f|--framework <FRAMEWORK>

Lägger bara till projektreferenser när du riktar in dig på ett specifikt ramverk med TFM-formatet.

-?|-h|--help

Skriver ut en beskrivning av hur du använder kommandot.

--interactive

Tillåter att kommandot stoppar och väntar på användarens indata eller åtgärd. Till exempel för att slutföra autentiseringen. Tillgänglig sedan .NET Core 3.0 SDK.

Exempel

Lägg till en projektreferens:

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

Lägg till en kompatibel .NET-projektreferens (till exempel F#) som fungerar i båda riktningarna:
```
dotnet add app/app.csproj reference lib/lib.fsproj
```
Lägg till flera projektreferenser till projektet i den aktuella katalogen:
```
dotnet reference add lib1/lib1.csproj lib2/lib2.csproj
```
Lägg till flera projektreferenser med ett globbande mönster i Linux/Unix:
```
dotnet reference add **/*.csproj --project app/app.csproj
```

Dela via