Dela via

dotnet-referenstillägg

Den här artikeln gäller för: ✔️ .NET 6 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