dotnet reference add

2025-04-03

Este artículo se aplica a: ✔️ SDK de .NET Core 3.1 y versiones posteriores

Nombre

dotnet reference add: agrega referencias de proyecto a proyecto (P2P).

Nota:

Si usa el SDK de .NET 9 o versiones anteriores, use el formulario "verbo primero" (dotnet add reference) en su lugar. El formato "nombre primero" se introdujo en .NET 10. Para obtener más información, consulte Orden de comandos más coherente.

Sinopsis

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

dotnet reference add -h|--help

Descripción

El comando dotnet reference add proporciona una opción cómoda para agregar referencias de proyecto a un proyecto. Después de ejecutar el comando, los elementos <ProjectReference> se agregan al archivo del proyecto.

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

Agregar una referencia a un ensamblado que no está en un proyecto

No hay ningún comando de la CLI para agregar una referencia a un ensamblado que no está en un proyecto ni en un paquete. Pero puede hacerlo editando el archivo de .csproj y agregando marcado similar al ejemplo siguiente:

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

Argumentos

PROJECT

Especifica el archivo del proyecto. Si no se especifica, el comando busca uno en el directorio actual.
PROJECT_REFERENCES

Referencias de proyecto a proyecto (P2P) que se van a agregar. Especifique uno o varios proyectos. de patrones Glob se admiten en sistemas basados en Unix/Linux.

Opciones

-f|--framework <FRAMEWORK>

Agrega referencias de proyecto solo cuando el destino es un marco de específico mediante el formato TFM.

-?|-h|--help

Imprime una descripción de cómo usar el comando .

--interactive

Permite que el comando se detenga y espere una entrada o una acción del usuario. Por ejemplo, para completar la autenticación. Disponible desde el SDK de .NET Core 3.0.

Ejemplos

Agregue una referencia de proyecto:

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

Agregue una referencia de proyecto de lenguaje .NET compatible (por ejemplo, F#), que funciona en ambas direcciones:
```
dotnet add app/app.csproj reference lib/lib.fsproj
```
Agregue varias referencias de proyecto al proyecto en el directorio actual:
```
dotnet reference add lib1/lib1.csproj lib2/lib2.csproj
```
Agregue varias referencias de proyecto mediante un patrón de globbing en Linux/Unix:
```
dotnet reference add **/*.csproj --project app/app.csproj
```

Compartir vía