Share via

Como: Adicionar ou remover referências no Visual Studio

  • Artigo

In order to use a component in your application, you must first add a reference to it. Visual Studioprovê cinco opções na caixa de diálogo Add Reference:

  • .NET lists all .NET Framework components available for referencing.

  • COM lists all COM components available for referencing.

  • Projects lists all reusable components created from local projects.

  • Browse enables you to browse for a component in the file system.

  • Recent contains a list of components recently added to projects on your computer.

The number of tabs available at the top of the Add Reference dialog box can vary, depending on the type of project open and the resources it is using. Projetos do C++ nativos contêm somente um projetos guia.

Alguns componentes na lista podem não ser exibidos, dependendo do .NET Framework versão do projeto. Isso pode ocorrer nas seguintes condições:

  • Um componente que usa uma versão recente do.NET Framework é incompatível com um projeto que se destina a uma versão anterior do.NET Framework.

    Para obter informações sobre como alterar o destino.NET Framework versão para um projeto, consulte Como: Destino de um específico.NET Framework versão ou perfil.

  • Um componente que usa .NET Framework 4 é incompatível com um projeto que se destina a .NET Framework 4 Client Profile.

    Quando você cria um novo aplicativo de destino alguns projetos de .NET Framework 4 Client Profile por padrão. For more information, see .NET Framework Client Profile.

Não é possível adicionar referências de cache global de assemblies, porque é estritamente parte do ambiente de tempo de execução.

Se você implantar ou copia um aplicativo que contém uma referência a um componente personalizado registrado no global assembly cache, o componente será não implantado ou copiado com o aplicativo, independentemente do Copy Local configuração. For more information, see Referências do projeto.

Você pode criar aplicativos que fazem referência a projetos ou assemblies destinados a uma versão diferente da.NET Framework. Por exemplo, você criaria um aplicativo voltado para o .NET Framework 4 Client Profile que referencia um assembly que visa .NET Framework versão 2.0. Se você criar um projeto que se destina a uma versão anterior da .NET Framework, você não pode definir uma referência do projeto para um projeto ou assembly voltado para o .NET Framework 4 Client Profile ou.NET Framework versão 4. For more information, see Direcionamento de um específico.NET Framework versão ou perfil.

You should avoid adding file references to outputs of another project in the same solution, because doing this may cause compilation errors. Instead, use the Projects tab of the Add Reference dialog box to create project-to-project references. This makes team development easier by enabling better management of the class libraries you create in your projects. For more information, see Solucionando Problemas de Referências Quebradas.

ObservaçãoObservação

Em 2010 Visual Studio, 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 é 2, 3 ou 3.5.

If you want to add a reference to a registered COM DLL that contains an internal manifest, make sure that you unregister the DLL first. If you do not, Visual Studio adds the assembly reference as an ActiveX Component instead of as a native DLL.

You can also add Web references by using the Add Web Reference dialog box. For more information, see Como: adicionar e remover referências da Web.

Quando você adiciona uma referência a qualquer um dos espaços para nome EnvDTE manualmente (EnvDTE, EnvDTE80, EnvDTE90, EnvDTE90a, ou EnvDTE100), defina a Incorporar tipos de interoperabilidade a propriedade de uma referência ao False na janela Propriedades. A definição dessa propriedade True causa pode criar problemas devido às determinadas propriedades de EnvDTE não podem ser incorporadas.

ObservaçãoObservação

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

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

To display an assembly in the Add Reference dialog box

  • Move or copy the assembly to one of the following locations:

    • The current project directory. (You can find these assemblies by using the Browse tab.)

    • Other project directories in the same solution. (You can find these assemblies by using the Projects tab.)

    - or -

  • Set a registry key that specifies the location of assemblies to display:

    Para um sistema operacional de 32 bits, adicione uma das seguintes 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 seguintes chaves de registro em um hive do registro de 32 bits.

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

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

    VersionMinimum é o mais baixo.NET Framework versão que se aplica. Se VersionMinimum for v 3.0, as pastas especificadas em AssemblyFoldersEx aplicar aos projetos de destino.NET Framework 3.0 e posterior.

    AssemblyLocation é o diretório dos assemblies que você deseja que apareça no Add Reference caixa de diálogo, por exemplo, C:\MyAssemblies\.

    Creating the registry key under the HKEY_LOCAL_MACHINE node allows all users to see the assemblies in the specified location in the Add Reference dialog box. Creating the registry key under the HKEY_CURRENT_USER node affects only the setting for the current user.

    Abrir o Add Reference caixa de diálogo novamente. Os assemblies devem aparecer na .NET guia. Se não tiverem, certifique-se de que os assemblies estão localizados no especificado AssemblyLocation directory, reinicie o Visual Studioe tente novamente.

To add a reference in Visual Basic

  1. In Solution Explorer, double-click the My Project node for the project.

  2. In the Project Designer, click the References tab.

  3. Click the Add button to open the Add Reference dialog box.

  4. In the Add Reference dialog box, select the tab indicating the type of component you want to reference.

  5. Select the components you want to reference, and then click OK.

    Dica

    You can select multiple components by holding down the CTRL key, provided the components are all on the same tab.

To add a reference in Visual C#

  1. In Solution Explorer, right-click the project node and click Add Reference.

  2. In the Add Reference dialog box, select the tab indicating the type of component you want to reference.

  3. Select the components you want to reference, and then click OK.

    Dica

    You can select multiple components by holding down the CTRL key, provided the components are all on the same tab.

To remove a reference in Visual Basic

  1. In Solution Explorer, double-click the My Project node for the project.

  2. In the Project Designer, click the References tab.

  3. In the References list, select the reference you want to remove.

  4. Click the Remove button.

    Dica

    You can also check your project for unused references and remove all of them at one time. For more information, see Como: Remover referências não utilizadas (Visual Basic).

To remove a reference in Visual C#

  1. In Solution Explorer, open the References node under the project node.

  2. Right-click a reference and click Remove.

Consulte também

Tarefas

Solucionando Problemas de Referências Quebradas

Como: Adicionar ou remover Namespaces (Visual Basic) importados

Como: Remover referências não utilizadas (Visual Basic)

Como: Defina a propriedade Copy Local de uma referência

Como: Adicionar novos itens de projeto

Como: adicionar e remover referências da Web

Como: Definir o caminho de referência (C#)

Referência

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

Avançado da caixa de diálogo Configurações do compilador (Visual Basic)

Conceitos

Referências do projeto

Referências da Web no Visual Studio

Visão geral de multiplataforma Visual Studio

Solução de problemas.Erros de direcionamento do NET Framework

Outros recursos

Gerenciando referências

Referenciando Namespaces e Componentes

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