dotnet add reference

  • Article

Cet article s’applique à : ✔️ SDK .NET Core 3.1 et versions ultérieures

Nom

dotnet add reference : ajoute des références entre projets (P2P).

Synopsis

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

dotnet add reference -h|--help

Description

La commande dotnet add reference est une option pratique pour ajouter des références de projet à un projet. Une fois que vous avez exécuté la commande, les éléments <ProjectReference> sont ajoutés au fichier projet.

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

Ajouter une référence à un assembly qui n’est pas dans un projet

Il n’existe aucune commande CLI permettant d’ajouter une référence à un assembly qui ne se trouve pas dans un projet ou un package. Toutefois, vous pouvez le faire en modifiant votre fichier .csproj et en ajoutant un balisage similaire à l’exemple suivant :

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

Arguments

  • PROJECT

    Spécifie le nom du fichier projet. Si aucun fichier n’est spécifié, la commande en recherche un dans le répertoire actuel.

  • PROJECT_REFERENCES

    Références entre projets (P2P) à ajouter. Spécifiez un ou plusieurs projets. Les modèles Glob sont pris en charge sur les systèmes Unix/Linux.

Options

  • -f|--framework <FRAMEWORK>

    Ajoute des références de projet uniquement lorsque vous ciblez un framework spécifique à l’aide du format TFM.

  • -?|-h|--help

    Imprime une description de l’utilisation de la commande.

  • --interactive

    Permet à la commande de s’arrêter et d’attendre une action ou une entrée utilisateur. Par exemple, pour effectuer une authentification. Option disponible à partir du kit SDK .NET Core 3.0.

Exemples

  • Ajouter une référence de projet :

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

  • Ajouter plusieurs références de projet au projet dans le répertoire actuel :

    dotnet add reference lib1/lib1.csproj lib2/lib2.csproj

  • Ajouter plusieurs références de projet à l’aide du modèle d’utilisation des caractères génériques (globbing) sur Linux/Unix :

    dotnet add app/app.csproj reference **/*.csproj