dotnet add reference

Article
12/27/2024

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

Nom

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

Synopsis

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

dotnet add reference -h|--help

Description

La commande dotnet add reference 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.

Options

-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 d’arrêter et d’attendre l’entrée ou l’action de l’utilisateur. Par exemple, pour terminer l’authentification. Disponible depuis le KIT SDK .NET Core 3.0.

Exemples

Ajoutez une référence de projet :

dotnet add app/app.csproj reference lib/lib.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 add reference lib1/lib1.csproj lib2/lib2.csproj
```
Ajoutez plusieurs références de projet à l’aide d’un modèle globbing sur Linux/Unix :
```
dotnet add app/app.csproj reference **/*.csproj
```

Partager via