dotnet add reference

  • Artículo

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

NOMBRE

dotnet add reference Agrega referencias entre proyectos (P2P) .

Sinopsis

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

dotnet add reference -h|--help

Descripción

El comando dotnet add reference constituye una opción práctica 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" />
</ItemGroup>

Adición de 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 .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 entre proyectos (P2P) que se van a agregar. Especifique uno o más proyectos. El patrón glob se admite en sistemas basados en Unix/Linux.

Opciones

  • -f|--framework <FRAMEWORK>

    Agrega referencias de proyecto solo cuando apunta a un marco específico con 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

  • Agregar una referencia de proyecto:

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

  • Agregar varias referencias de proyecto al proyecto en el directorio actual:

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

  • Agregar varias referencias de proyecto usando el patrón global en Linux/Unix:

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