Partager via

Gérer les dépendances de package dans les applications .NET

Cet article explique comment ajouter et supprimer des dépendances de package en modifiant le fichier projet ou à l’aide de l’interface CLI.

Élément <PackageReference>

L’élément <PackageReference> de fichier projet a la structure suivante :

<PackageReference Include="PACKAGE_ID" Version="PACKAGE_VERSION" />

L’attribut Include spécifie l’ID du package à ajouter au projet. L’attribut Version spécifie la version à obtenir. Les versions sont spécifiées conformément aux règles de version NuGet.

Utilisez des conditions pour ajouter une dépendance disponible uniquement dans une cible spécifique, comme illustré dans l’exemple suivant :

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

La dépendance dans l’exemple précédent ne sera valide que si la build se produit pour cette cible donnée. Dans la condition, $(TargetFramework) est une propriété MSBuild définie dans le projet. Pour les applications .NET les plus courantes, vous n’avez pas besoin de le faire.

Ajouter et supprimer des dépendances

Vous pouvez ajouter et supprimer des dépendances en modifiant votre fichier projet ou via des commandes CLI .NET .

Modifier le fichier projet

Pour ajouter une dépendance, ajoutez un <PackageReference> élément à l’intérieur d’un <ItemGroup> élément. Vous pouvez ajouter à un existant <ItemGroup> ou en créer un.

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

  <PropertyGroup>
    ...
  </PropertyGroup>

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

</Project>

Pour supprimer une dépendance, supprimez son <PackageReference> élément du fichier projet.

Utiliser l’interface CLI

Pour ajouter une dépendance, exécutez la dotnet package add commande, comme illustré dans l’exemple suivant. (Si vous utilisez une version du Kit de développement logiciel (SDK) de .NET 9 ou antérieure, utilisez plutôt le dotnet add package formulaire.)

dotnet package add Microsoft.EntityFrameworkCore

Pour supprimer une dépendance, exécutez la dotnet package remove commande, comme illustré dans l’exemple suivant. (Si vous utilisez une version du Kit de développement logiciel (SDK) de .NET 9 ou antérieure, utilisez plutôt le dotnet remove package formulaire.)

dotnet package remove Microsoft.EntityFrameworkCore

Conseils

  • N’incluez pas d’entrées dans l’opération de restauration dans le fichier .targets ou .props d’un package référencé. Ces entrées peuvent inclure des PackageReference éléments, ExcludeAssets des attributs, des flux NuGet à utiliser ou d’autres configurations NuGet. Les fichiers .targets et .props des packages ne sont pas utilisés tant qu’une fois la restauration NuGet terminée. Tout ce qui est nécessaire pour la restauration doit se trouver dans le fichier projet ou le fichier .targets du projet lui-même, et non dans une dépendance de package.

  • Si vous souhaitez utiliser ASP.NET API dans une application console ou une bibliothèque de classes, ajoutez un élément FrameworkReference à votre fichier projet :

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

    Pour plus d’informations, consultez Utiliser l’infrastructure partagée ASP.NET Core.

Voir aussi

  • Last updated on