dotnet referência adicionar

Este artigo aplica-se a: ✔️ .NET 6 SDK 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 a forma "verbo primeiro" (dotnet add reference) em vez disso. A forma "substantivo primeiro" foi introduzida no .NET 10. Para obter mais informações, consulte 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 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 de .csproj do 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 procura um no diretório atual.

• PROJECT_REFERENCES

  Referências de projeto a projeto (P2P) para adicionar. Especifique um ou mais projetos. padrões Glob são suportados 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 a entrada ou ação do usuário. Por exemplo, para concluir a autenticação.

Exemplos

• Adicione uma referência de projeto:

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

• Adicione uma referência de projeto compatível com a linguagem .NET (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