adicionar referência do dotnet

Artigo
2025-04-03

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

Nome

dotnet reference add – adiciona referências de projeto a projeto (P2P).

Observação

Se você estiver usando o SDK do .NET 9 ou anterior, use o formulário "verbo primeiro" (dotnet add reference) em vez disso. O formulário "substantivo primeiro" foi introduzido no .NET 10. Para obter mais informações, consulte a ordem de comando mais consistente.

Sinopse

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

dotnet reference add -h|--help

Descrição

O comando dotnet reference add 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" />
  <ProjectReference Include="..\lib3\lib3.fsproj" />
</ItemGroup>

Adicionar uma referência a um assembly que não está 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. Mas você pode fazer isso editando seu arquivo .csproj e adicionando marcação semelhante ao exemplo a seguir:

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

Argumentos

PROJECT

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

Referências de projeto a projeto (P2P) a serem adicionadas. Especifique um ou mais projetos. padrões glob têm suporte em sistemas baseados em Unix/Linux.

Opções

-f|--framework <FRAMEWORK>

Adiciona referências de projeto somente ao direcionar uma estrutura de específica 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 uma referência de projeto:

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

Adicione uma referência de projeto de linguagem .NET compatível (por exemplo, F#), que funciona em ambas as direções:
```
dotnet add app/app.csproj reference lib/lib.fsproj
```
Adicione várias referências de projeto ao projeto no diretório atual:
```
dotnet reference add lib1/lib1.csproj lib2/lib2.csproj
```
Adicione várias referências de projeto usando um padrão de globbing no Linux/Unix:
```
dotnet reference add **/*.csproj --project app/app.csproj
```

Compartilhar via