Afhankelijkheden in .NET toepassingen beheren

In dit artikel wordt uitgelegd hoe u afhankelijkheden van pakketten, projecten en assembly's toevoegt en verwijdert.

Pakketafhankelijkheden toevoegen en verwijderen

U kunt afhankelijkheden toevoegen en verwijderen door het projectbestand of via .NET CLI-opdrachten te bewerken.

De CLI gebruiken

Voer de dotnet package opdracht voor uw SDK-versie uit om een afhankelijkheid toe te voegen:

dotnet package add Microsoft.EntityFrameworkCore

Als u een afhankelijkheid wilt verwijderen, voert u de dotnet package opdracht voor uw SDK-versie uit:

dotnet package remove Microsoft.EntityFrameworkCore

Het projectbestand bewerken

Als u een afhankelijkheid wilt toevoegen, voegt u een <PackageReference> item in een <ItemGroup> element toe. U kunt aan een bestaande <ItemGroup> toevoegen of een nieuwe maken.

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    ...
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.EntityFrameworkCore" Version="3.1.2" />
  </ItemGroup>

</Project>

Het Include kenmerk geeft de id op van het pakket dat moet worden toegevoegd aan het project. Het Version kenmerk geeft de versie op die moet worden opgehaald. Versies worden opgegeven volgens nuGet-versieregels.

Gebruik voorwaarden om een afhankelijkheid toe te voegen die alleen beschikbaar is in een specifiek doel, zoals wordt weergegeven in het volgende voorbeeld:

<PackageReference Include="PACKAGE_ID" Version="PACKAGE_VERSION" Condition="'$(TargetFramework)' == 'netcoreapp2.1'" />

De afhankelijkheid in het voorgaande voorbeeld is alleen geldig als de build plaatsvindt voor dat opgegeven doel. De $(TargetFramework) voorwaarde is een MSBuild-eigenschap die wordt ingesteld in het project. Voor de meest voorkomende .NET-toepassingen hoeft u dit niet te doen.

Als u een afhankelijkheid wilt verwijderen, verwijdert u het <PackageReference> item uit het projectbestand.

Zie de PackageReference voor meer informatie over het item.

Projectverwijzingen toevoegen en verwijderen

Gebruik een project-naar-projectverwijzing wanneer uw project afhankelijk is van een ander project. Als u projectverwijzingen wilt toevoegen en verwijderen, bewerkt u het projectbestand of gebruikt u de CLI.

De CLI gebruiken

Als u een projectreferentie wilt toevoegen, voert u de dotnet reference opdracht voor uw SDK-versie uit.

dotnet reference add ../MyLibrary/MyLibrary.csproj

Als u een projectreferentie wilt verwijderen, voert u de volgende opdracht uit voor uw SDK-versie:

dotnet reference remove ../MyLibrary/MyLibrary.csproj

Het projectbestand bewerken

Het <ProjectReference> projectbestandselement identificeert het pad naar het project waarnaar wordt verwezen. Als u een projectreferentie wilt toevoegen, voegt u een <ProjectReference> item in een <ItemGroup> element toe. U kunt aan een bestaande <ItemGroup> toevoegen of een nieuwe maken.

<ItemGroup>
  <ProjectReference Include="../MyLibrary/MyLibrary.csproj" />
</ItemGroup>

Als u een projectreferentie wilt verwijderen, verwijdert u het <ProjectReference> element uit het projectbestand.

Zie ProjectReference voor meer informatie over het item .

Assemblyverwijzingen toevoegen en verwijderen

U kunt assemblyverwijzingen toevoegen en verwijderen via het projectbestand. De .NET CLI biedt geen opdrachten om assemblyverwijzingen toe te voegen of te verwijderen.

Als u wilt verwijzen naar een .NET assembly die geen deel uitmaakt van een project of pakket, voegt u een <Reference> element toe aan het projectbestand. Gebruik het <HintPath> element om het relatieve of absolute pad naar de assembly op te geven:

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

Als u een assembly-verwijzing wilt verwijderen, verwijdert u het <Reference> element uit het projectbestand.

Zie Reference voor meer informatie over het -item.

Tips

  • Neem geen invoer op voor de herstelbewerking in het .targets - of .props-bestand van een pakket waarnaar wordt verwezen. Deze invoer kan PackageReference items, ExcludeAssets kenmerken, de NuGet-feeds bevatten die moeten worden gebruikt of een andere NuGet-configuratie. De .targets - en .props-bestanden van pakketten worden pas gebruikt nadat NuGet-herstel is voltooid. Alles wat nodig is voor herstel moet zich in het projectbestand of het .targets-bestand van het project zelf, niet in een pakketafhankelijkheid.

  • Als u ASP.NET API's wilt gebruiken in een consoletoepassing of klassebibliotheek, voegt u een FrameworkReference-item toe aan uw projectbestand:

    <FrameworkReference Include="Microsoft.AspNetCore.App" />

    Zie Het gedeelde ASP.NET Core-framework gebruiken voor meer informatie.

Zie ook

  • Laatst bijgewerkt om