dotnet add reference

  • Artigo

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

Nome

dotnet add reference – Adiciona as referências P2P (projeto a projeto).

Sinopse

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

dotnet add reference -h|--help

Descrição

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

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

Adicionar uma referência a um assembly que não esteja em um projeto

Não há nenhum comando da CLI para adicionar uma referência a um assembly que não esteja em um projeto ou pacote. Contudo, isso pode ser feito editando seu arquivo .csproj e adicionando uma marcação semelhante ao seguinte exemplo:

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

Argumentos

  • PROJECT

    Especifica o arquivo do projeto. Se não for especificado, o comando pesquisará um no diretório atual.

  • PROJECT_REFERENCES

    Referências P2P (projeto a projeto) a serem adicionadas. Especifique um ou mais projetos. Os padrões Glob são compatíveis com sistemas baseados em Unix/Linux.

Opções

  • -f|--framework <FRAMEWORK>

    Adiciona referências de projeto somente quando houver uma estrutura específica como destino usando o formato TFM.

  • -?|-h|--help

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

  • --interactive

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

Exemplos

  • Adicionar referência de projeto:

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

  • Adicionar várias referências de projeto ao projeto no diretório atual:

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

  • Adicionar várias referências de projeto usando um padrão de recurso de curinga no Linux/Unix:

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