dotnet référence ajouter (ajouter une référence)

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

Nom

dotnet reference add : ajoute des références de projet à projet (P2P).

Remarque

Si vous utilisez le Kit de développement logiciel (SDK) .NET 9 ou une version antérieure, utilisez le formulaire « verbe premier » (dotnet add reference) à la place. Le formulaire « nom premier » a été introduit dans .NET 10. Pour plus d’informations, consultez Ordre de commande plus cohérent.

Synopsis

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

dotnet reference add -h|--help

Description

La commande dotnet reference add fournit une option pratique pour ajouter des références de projet à un projet. Après avoir 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" />
  <ProjectReference Include="..\lib3\lib3.fsproj" />
</ItemGroup>

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

Il n’existe aucune commande CLI pour ajouter une référence à un assembly qui n’est pas dans un projet ou un package. Toutefois, vous pouvez le faire en modifiant votre fichier .csproj et en ajoutant des marques similaires à l’exemple suivant :

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

Arguments

• PROJECT

  Spécifie le fichier projet. Si elle n’est pas spécifiée, la commande recherche un répertoire actif.

• PROJECT_REFERENCES

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

Paramètres

• -f|--framework <FRAMEWORK>

  Ajoute des références de projet uniquement lors du ciblage d’une infrastructure 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.

Exemples

• Ajoutez une référence de projet :

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

• Ajoutez une référence de projet .NET compatible (par exemple, F#), qui fonctionne dans les deux sens :

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

• Ajoutez plusieurs références de projet au projet dans le répertoire actif :

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

• Ajoutez plusieurs références de projet à l’aide d’un modèle globbing sur Linux/Unix :

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