dotnet add reference

Artigo
03/28/2023

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
```

Compartilhar via