Gerenciando referências em um projeto

 

Para obter a documentação mais recente do Visual Studio 2017 RC, consulte a documentação do Visual Studio 2017 RC.

Antes de escrever código contra um componente externo ou serviço conectado, o projeto primeiro deve conter uma referência a ele. Uma referência é essencialmente uma entrada em um arquivo de projeto que contém as informações que o Visual Studio precisa para localizar o componente ou o serviço.

Para adicionar uma referência, clique com o botão direito no nó referências no Gerenciador de soluções e escolha Adicionar referência. Para obter mais informações, consulte Como: Adicionar ou remover referências usando o Gerenciador de Referências.

Add a reference in Visual C++

Você pode fazer uma referência para os seguintes tipos de componentes/serviços:

  • Referências de aplicativo da Windows Store

  • Bibliotecas de classes do .NET framework ou assemblies

  • componentes COM

  • Outros assemblies ou bibliotecas de classes de projetos na mesma solução

  • Serviços Web XML

Referências de projeto

Projetos de plataforma do Windows (UWP) universais voltados para Windows 10 podem criar referências a outros projetos UWP na solução ou projetos da Windows Store ou binários destino Windows 8.1, desde que esses projetos não usem APIs foram preteridos no Windows 10. Para obter mais informações, consulte Mover do Windows 8 do tempo de execução para UWP.

Se você optar por redirecionar Windows 8.1 projetos Windows 10, consulte Portando, migrando e atualizando projetos do Visual Studio

Referências SDK de extensão

Projetos Visual Basic, c#, C++ e JavaScript da Windows Store que se destinam a plataforma do Windows Universal (UWP) podem fazer referência a SDKs de extensão de destino Windows 8.1, desde que estes SDKs de extensão não usa APIs que foram substituídos no Windows 10. Verifique o site do fornecedor do SDK de extensão para saber se ele pode ser referenciado por projetos da Windows Store destinados UWP.

Se você determinar que não há suporte para o SDK de extensão que está sendo referenciado por seu aplicativo, você precisa executar as seguintes etapas:

  1. Observe o nome do projeto que está causando o erro. A plataforma de que seu projeto está definido é indicada entre parênteses ao lado do nome do projeto. Por exemplo, MyProjectName (Windows 8.1) significa que seu projeto MyProjectName está voltada para a versão da plataforma Windows 8.1.

  2. Vá para o site do fornecedor que possui o SDK de extensão sem suporte e instale a versão do SDK de extensão com dependências que são compatíveis com a versão da plataforma do que seu projeto está definido.

    System_CAPS_ICON_note.jpg Observação

    Uma maneira de descobrir se um SDK de extensão tem dependências em outros SDKs de extensão é reiniciar o Visual Studio, crie um novo projeto do c# da Windows Store, clique com botão direito no projeto e escolha Adicionar referência, vá para o Windows tab, vá para o extensões subguia, selecione o SDK de extensão e examine o painel direito no Gerenciador de referências. Se ele possui dependências, eles serão listados lá.

    System_CAPS_ICON_important.jpg Importante

    Se seu projeto está voltada para Windows 10 e o SDK de extensão instalado na etapa anterior tem uma dependência no pacote de tempo de execução do Microsoft Visual C++, a versão do pacote Microsoft Visual C++ Runtime que é compatível com o Windows 10 é v14.0 e é instalada com o Visual Studio 2015.

  3. Se o SDK de extensão que você instalou na etapa anterior tem dependências em outros SDKs de extensão, vá para os sites do fornecedor (es) que possuem as dependências e instale as versões dessas dependências que são compatíveis com a versão da plataforma do seu projeto está definido.

  4. Reinicie o Visual Studio e abra seu aplicativo.

  5. Clique com botão direito no referências nó no projeto que causou o erro e escolha Adicionar referência

  6. Clique o Windows guia e, em seguida, o extensões subguia, em seguida, desmarque as caixas de seleção para os SDKs de extensão antigo e marque as caixas de seleção para os novos SDKs de extensão. Clique em OK.

Quando você faz uma referência a um assembly em seu projeto, Visual Studio procura o assembly nos seguintes locais:

  • O diretório do projeto atual. (Você pode encontrar esses assemblies usando o Procurar guia.)

  • Outros diretórios de projeto na mesma solução. (Você pode encontrar esses assemblies no projetos guia.)

System_CAPS_ICON_note.jpg Observação

Todos os projetos contêm uma referência implícita a mscorlib. Projetos do Visual Basic contêm uma referência implícita a Microsoft.VisualBasic.

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

Em tempo de execução, componentes devem ser no caminho de saída do projeto ou no Cache de assemblies global (GAC). Se o projeto contiver uma referência a um objeto que não esteja em um desses locais, você deve copiar a referência para o caminho de saída do projeto quando você compilar o projeto. O CopyLocal propriedade indica se esta cópia precisa ser feita. Se o valor for True, a referência é copiada para o diretório do projeto quando você compilar o projeto. Se o valor for False, a referência não é copiada.

Se você implantar um aplicativo que contém uma referência a um componente personalizado que está registrado no GAC, o componente não ser implantado com o aplicativo, independentemente do CopyLocal configuração. Em versões anteriores do Visual Studio, você pode definir o CopyLocal propriedade em uma referência para garantir que o assembly foi implantado. Agora, você deve adicionar manualmente o assembly para a pasta \Bin. Isso coloca todo código personalizado sob exame detalhado, reduzindo o risco de publicar código personalizado com o qual você não está familiarizado.

Por padrão, o CopyLocal está definida como False se o assembly ou componente está no cache de assembly global ou é um componente de estrutura. Caso contrário, o valor é definido como True. Referências de projeto a projeto são sempre definidas como True.

Você pode criar aplicativos que fazem referência a projetos ou assemblies que uma versão diferente do .NET Framework de destino. Por exemplo, você pode criar um aplicativo que tem como alvo o .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 do .NET Framework, você não pode definir uma referência no projeto para um projeto ou assembly que tem como alvo o .NET Framework 4 Client Profile ou o .NET Framework versão 4.

Para obter mais informações, consulte Direcionamento de uma versão específica do .NET Framework.

Referências de projeto a projeto são referências a projetos que contêm assemblies; Você pode criá-los usando o projeto guia. Visual Studio pode encontrar um assembly quando é fornecido um caminho para o projeto.

Quando você tiver um projeto que produz um assembly, você deve referenciar o projeto e não usar uma referência de arquivo (veja abaixo). A vantagem de uma referência de projeto a projeto é que ele cria uma dependência entre os projetos no sistema de compilação. O projeto dependente será criado se ele tiver sido alterado desde a última vez que o projeto de referência foi criado. Uma referência de arquivo não cria uma dependência de compilação, portanto, é possível criar o projeto de referência sem a criação do projeto dependente e a referência pode se tornar obsoleta. (Ou seja, o projeto pode fazer referência um versão anteriormente criada do projeto.) Isso pode resultar em várias versões de uma única DLL seja necessária no diretório bin, que não é possível. Quando esse conflito ocorre, você verá uma mensagem como Aviso: o 'arquivo' de dependência no projeto 'projeto' não pode ser copiada para o diretório de execução porque ela substituiria o 'arquivo' de referência.. Para obter mais informações, consulte Solucionando Problemas de Referências Quebradas e Como criar e remover dependências de projeto.

System_CAPS_ICON_note.jpg Observação

Uma referência de arquivo em vez de uma referência de projeto para o projeto será criada se a versão de destino do .NET Framework de um projeto é a versão 4.5, e a versão de destino do outro projeto, versão 2, 3, 3.5 ou 4.0.

Referências de arquivo são referências diretas aos assemblies fora do contexto de um projeto do Visual Studio; criá-los usando o Procurar guia de Gerenciador de referências. Use uma referência de arquivo quando você tiver um assembly ou componente apenas e não tiver o projeto que cria como saída.

Solucionando Problemas de Referências Quebradas
Programação com assemblies
Como: Adicionar ou remover referências usando o Gerenciador de Referências

Mostrar: