dotnet adicionar referência

Este artigo aplica-se a: ✔️ SDK .NET Core 3.1 e versões posteriores

Name

dotnet add reference - Adiciona referências de projeto a projeto (P2P).

Sinopse

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

dotnet add reference -h|--help

Description

O dotnet add reference comando fornece uma opção conveniente para adicionar referências de projeto a um projeto. Depois de executar o comando, os <ProjectReference> elementos são adicionados ao ficheiro de projeto.

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

Adicionar uma referência a uma assemblagem que não está num projeto

Não existe nenhum comando da CLI para adicionar uma referência a uma assemblagem que não esteja num projeto ou num pacote. Mas pode fazê-lo ao editar o ficheiro .csproj e ao adicionar marcações semelhantes ao seguinte exemplo:

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

Argumentos

  • PROJECT

    Especifica o ficheiro de projeto. Se não for especificado, o comando procura um no diretório atual.

  • PROJECT_REFERENCES

    Referências projeto a projeto (P2P) a adicionar. Especifique um ou mais projetos. Os padrões Glob são suportados em sistemas baseados em Unix/Linux.

Opções

  • -f|--framework <FRAMEWORK>

    Adiciona referências de projeto apenas ao filtrar uma arquitetura específica com o formato TFM.

  • -?|-h|--help

    Imprime uma descrição de como utilizar o comando .

  • --interactive

    Permite que o comando pare e aguarde pela entrada ou ação do utilizador. Por exemplo, para concluir a autenticação. Disponível desde o SDK .NET Core 3.0.

Exemplos

  • Adicionar uma referência de projeto:

    dotnet add app/app.csproj reference lib/lib.csproj
    
  • Adicione várias referências de projeto ao projeto no diretório atual:

    dotnet add reference lib1/lib1.csproj lib2/lib2.csproj
    
  • Adicione várias referências de projeto através de um padrão de globbing no Linux/Unix:

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