Como adicionar ou remover referências usando a caixa de diálogo Adicionar Referência

  • Artigo

Para usar um componente em seu aplicativo, é necessário primeiro adicionar uma referência a ele.Visual Studio fornece cinco opções na caixa de diálogo Adicionar Referência:

  • .NET lista todos os componentes do .NET Framework disponíveis para referência.

  • COM lista todos os componentes COM disponíveis para referência.

  • Projects lista todos os componentes reutilizáveis criados em projetos locais.

  • Browse permite que você procure por um componente no sistema de arquivos.

  • Recent contém uma lista dos componentes recentemente adicionados aos projetos em seu computador.

O número de guias disponíveis na parte superior da caixa de diálogo Adicionar Referência pode variar, dependendo do tipo de projeto aberto e os recursos que está usando.Os projetos nativos de C++ contêm somente uma guia de Projetos.

Alguns componentes na lista não podem ser exibidos, dependendo da versão de .NET Framework do seu projeto.Isso pode ocorrer nas seguintes circunstâncias:

  • Um componente que usa uma versão recente do .NET Framework é incompatível com um projeto que tem como alvo uma versão anterior do .NET Framework.

    Para obter informações sobre como alterar a versão alvo do .NET Framework para um projeto, consulte Como destinar uma versão do .NET Framework.

  • Um componente que usa o .NET Framework 4 é incompatível com um projeto que tem como alvo o .NET Framework 4 Client Profile.

    Ao criar um novo aplicativo, alguns projetos direcionam .NET Framework 4 Client Profile por padrão.Para obter mais informações, consulte .NET Framework Client Profile.

Não é possível adicionar referências do cache global de assembly porque ele é parte estrita do ambiente de tempo de execução.

Se você implantar um aplicativo que contém uma referência a um componente personalizado que está registrado no cache global de assembly, o componente não será implantado com o aplicativo, independentemente da configuração Copy Local.Para obter mais informações, consulte Gerenciando referências do projeto.

Você pode criar aplicativos que fazem referência a projetos ou assemblies destinados a uma versão diferente do .NET Framework.Por exemplo, você pode criar um aplicativo que destine o .NET Framework 4 Client Profile que faz referência a um assembly destinado a .NET Framework 2,0.Se você criar um projeto que tenha como destino uma versão anterior do .NET Framework, não poderá definir uma referência no projeto para um projeto ou assembly que tenha como destino o .NET Framework 4 Client Profile ou o .NET Framework versão 4.Para obter mais informações, consulte Destinando uma versão do .NET Framework específica ou perfil.

Você deve evitar adicionar referências de arquivo a saídas de outro projeto na mesma solução, porque isso pode causar erros de compilação.Em vez disso, use a guia Projetos da caixa de diálogo Adicionar Referência para criar referências projeto-a-projeto.Isso torna o desenvolvimento em equipe mais fácil, permitindo melhor gerenciamento das bibliotecas de classes criadas em seus projetos.Para obter mais informações, consulte Solucionando Problemas de Referências Quebradas.

ObservaçãoObservação

No Visual Studio 2010, uma referência de arquivo em vez de uma referência de projeto é criada se a versão de destino do .NET Framework de um projeto é a versão 4, e a versão de destino de outro projeto é a versão 2, 3, ou 3.5.

Se você desejar adicionar uma referência a uma DLL COM registrada que contém um manifesto interno, certifique-se de cancelar o registro de DLL primeiro.Se você não fizer isso, o Visual Studio adicionará a referência do assembly como um componente ActiveX, em vez de como uma DLL nativa.

Você também pode adicionar referências Web na caixa de diálogo Adicionar Referência Web.Para obter mais informações, consulte How to: Add and Remove Web References.

Ao adicionar manualmente uma referência em qualquer namespace de EnvDTE (EnvDTE, EnvDTE80, EnvDTE90, EnvDTE90a, ou EnvDTE100), defina a propriedade de Inserir Tipos Interop da referência para Falso na janela de propriedades.Definir essa propriedade como Verdadeiro poderá causar problemas de compilação devido a determinadas propriedades de EnvDTE que não podem ser inseridas.

ObservaçãoObservação

Todos os projetos contém uma referência implícita ao mscorlib.Os projetos do Visual Basic contêm uma referência implícita ao Microsoft.VisualBasic.

No Visual Studio 2010, todos os projetos contêm uma referência implícita a System.Core, mesmo se System.Core for removido da lista de referências.

Para exibir um assembly na caixa de diálogo Adicionar Referência

  • Mova ou copie o assembly para um dos seguintes locais:

    • O diretório do projeto atual. (É possível encontrar esses conjuntos de módulos (assemblies) usando a guia Procurar.)

    • Outros diretórios de projeto na mesma solução. (É possível encontrar esses conjuntos de módulos (assemblies) usando a guia Projetos).

    - ou -

  • Defina uma chave de registro que especifica o local dos conjuntos de módulos (assemblies) a serem exibidos:

    Para um sistema operacional de 32 bits, adicione uma das chaves de registro.

    • [HKEY_CURRENT_USER\SOFTWARE\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    • [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    Para um sistema operacional de 64 bits, adicione uma das chaves de registro em uma seção de 32 bits do registro.

    • [HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    • [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    VersionMinimum é a versão mais antiga do .NET Framework que se aplica.Se VersionMinimum for v3.0, as pastas especificadas em AssemblyFoldersEx se aplicarão aos projetos que têm como alvo o .NET Framework 3.0 e posterior.

    AssemblyLocation é o diretório de assemblies que você deseja que apareça na caixa de diálogo Adicionar Referência, por exemplo, C:\MyAssemblies\.

    Criar a chave de registro sob o nó HKEY_LOCAL_MACHINE permite que todos os usuários vejam os conjuntos de módulos (assemblies) no local especificado na caixa de diálogo Adicionar referência.Criar a chave de registro sob o nó HKEY_CURRENT_USER afeta somente a configuração para o usuário atual.

    Abra a caixa de diálogo Adicionar Referência novamente.Os assemblies devem aparecer na guia .Net.Se não tiverem, garanta que os conjuntos de módulos (assemblies) estão localizado na pasta AssemblyLocation especificada, reinicie o Visual Studio, e tente novamente.

Para adicionar uma referência no Visual Basic

  1. No Gerenciador de Soluções, clique duas vezes no nó Meu Projeto do projeto.

  2. No Designer de Projeto, clique na guia Referências.

  3. Clique no botão Adicionar referência para abrir a caixa de diálogo Adicionar referência.

  4. Na caixa de diálogo Adicionar Referência, selecione a guia indicando o tipo de componente que você deseja referenciar.

  5. Selecione os componentes que você deseja fazer referência e, em seguida, clique em OK.

    DicaDica

    Você pode selecionar vários componentes mantendo pressionada a tecla CTRL, desde que os componentes estejam todos na mesma guia.

Para adicionar uma referência no Visual C#

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e clique em Adicionar Referência.

  2. Na caixa de diálogo Adicionar Referência, selecione a guia indicando o tipo de componente que você deseja referenciar.

  3. Selecione os componentes que você deseja fazer referência e, em seguida, clique em OK.

    DicaDica

    Você pode selecionar vários componentes mantendo pressionada a tecla CTRL, desde que os componentes estejam todos na mesma guia.

Para remover uma referência no Visual Basic

  1. No Gerenciador de Soluções, clique duas vezes no nó Meu Projeto do projeto.

  2. No Designer de Projeto, clique na guia Referências.

  3. Na lista Referências, selecione a referência que deseja remover.

  4. Clique no botão Remover.

    DicaDica

    Você também pode verificar seu projeto procurando referências não utilizadas e remover todas elas de uma vez.Para obter mais informações, consulte How to: Remove Unused References (Visual Basic).

Para remover uma referência no Visual C#

  1. No Gerenciador de Soluções, abra o nó Referências abaixo do nó do projeto.

  2. Clique com o botão direito do mouse uma referência e clique em Remover.

Consulte também

Tarefas

Solucionando Problemas de Referências Quebradas

Como adicionar ou remover namespaces importados (Visual Basic)

Referência

Página Aplicativo, Designer de Projeto (C#)

Caixa de diálogo Configurações de Compilador Avançadas (Visual Basic)

Conceitos

Gerenciando referências do projeto

Como: Adicionar ou remover referências usando o Gerenciador de Referências

Gerenciando referências do projeto

Visão geral de multissegmentação do Visual Studio

Solução de problemas com erros de direcionamento do .NET Framework

Outros recursos

Destinando uma versão do .NET Framework específica ou perfil