Compartilhar via

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

  • Artigo

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

  • .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 do sistema de arquivos.

  • RecentContém uma lista de componentes recentemente adicionados a 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 C++ contêm somente um 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 de destino do.NET Framework para um projeto, consulte Como: usar uma versão do.NET Framework.

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

    Quando você cria um novo aplicativo, alguns projetos destinam-se .NET Framework 4 Client Profile por padrão.Para obter mais informações, consulte .NET Framework Client Profile.

Você não pode adicionar referências assembly cache global porque é estritamente parte 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 na cache global de assemblies, o componente não será implantado com o aplicativo, independentemente da configuração de Copy Local .Para obter mais informações, consulte Gerenciando referências do projeto.

Você pode criar aplicativos que referenciam os projetos ou assemblies que tenham como alvo uma versão diferente do .NET Framework.Por exemplo, você poderia criar um aplicativo que destinasse .NET Framework 4 Client Profile que referencia um assembly que tem como alvo .NET Framework 2.0.Se você criar um projeto que tem como alvo uma versão anterior de .NET Framework, você não pode definir uma referência no projeto a um projeto ou em um assembly que se aplica a versão 4. .NET Framework 4 Client Profile de ou do .NET Framework.Para obter mais informações, consulte Almejando um específico.NET Framework versão 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 Projectsda caixa de diálogo Add Referencepara criar referências project-to-project.Isso torna desenvolvimento em equipe mais fácil, permitindo melhor gerenciamento das bibliotecas de classes criadas em seus projetos.Para obter mais informações, consulte Solução de 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 do outro projeto é a versão 2, 3, 3,5 ou.

Se você deseja adicionar uma referência a uma DLL registrada COM que contém um manifesto interno, certifique-se de cancelar o registro de DLL pela primeira vez.Se você não fizer isso, 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 Add Web Reference.Para obter mais informações, consulte How to: Add and Remove Web References.

Quando você adicionar manualmente uma referência a qualquer namespaces de EnvDTE (EnvDTE, EnvDTE80, EnvDTE90, EnvDTE90a, ou EnvDTE100), defina a propriedade de Inserir Tipos Interop referência a False na janela propriedades.Defina essa propriedade como True pode 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 para mscorlib.Os projetos do Visual Basic contém uma referência implícita a Microsoft.VisualBasic.

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

A Caixa de diálogo Adicionar Referência permite a você adicionar um assembly.

  • Mover ou copiar o conjunto para um dos seguintes locais:

    • O diretório do projeto atual.(Você pode encontrar esses conjuntos de módulos (assemblies) usando a guia Browse).

    • Outros diretórios de projeto na mesma solução. (Você pode encontrar esses conjuntos de módulos (assemblies) usando a guia Browse).

    - ou -

  • Defina um chave do Registro que especifica o local dos conjuntos de módulos (assemblies) para exibir:

    Para um sistema operacional de 32 bits, adicione uma das seguintes chaves do Registro.

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

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

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

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

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

    VersionMinimum é a menor versão do.NET Framework que se aplica.Se VersionMinimum é v3.0, as pastas especificadas em AssemblyFoldersEx se aplicam a projetos que destinam-se o .NET Framework 3,0 e posterior.

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

    Criar a chave do 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álogoAdd Reference.Criar o chave do Registro sob o nó HKEY_CURRENT_USER afeta somente a configuração para o usuário atual.

    Abra a caixa de diálogo de Adicionar Referência novamente.Assemblies devem aparecer na guia do .NET .Se não, para garantir que os assemblies serem posicionados no diretório especificado de AssemblyLocation , reinicie o Visual Studio, e tente novamente.

Para adicionar uma referência em Visual Basic

  1. No Solution Explorer, clique duas vezes com o nó My Project do projeto.

  2. No Project Designer, clique na guia References.

  3. Clique no botão Add reference para abrir a caixa de diálogo Add References.

  4. Na caixa de diálogo Add Reference, 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 Solution Explorer, clique com o botão direito do mouse no nó do projeto de clique em Add Rreference.

  2. Na caixa de diálogo Add Reference, 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 em Visual Basic

  1. No Solution Explorer, clique duas vezes com o nó My Project do projeto.

  2. No Project Designer, clique na guia References.

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

  4. Clique no botão Remove.

    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 Solution Explorer, abra o nóReferences 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

Solução de problemas de referências quebradas

Como: Adicionar ou remover Namespaces (Visual Basic) importados

Referência

Página de aplicativo, Designer de projeto (C#)

Avançado da caixa de diálogo Configurações do compilador (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 multiplataforma Visual Studio

Solução de problemas.NET Framework direcionamento erros

Outros recursos

Almejando um específico.NET Framework versão ou perfil