Compartilhar via


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

Você pode usar a caixa de diálogo do Gerenciador de referência para adicionar e gerenciar as referências a componentes que você, Microsoft, ou outra empresa desenvolveram.Se você estiver desenvolvendo um aplicativo de Windows Store , seu projeto referencia automaticamente qualquer Windows 8 SDK e o.NET Framework.Se você estiver desenvolvendo um outro tipo de projeto, você deve adicionar essas referências para o projeto manualmente.

Observação de cuidadoCuidado

Você pode adicionar referências em outros tipos de projetos usando a caixa de diálogo de Adicionar Referência .Para obter mais informações, consulte Como: Adicionar ou remover referências usando a caixa de diálogo Adicionar referência.

Adicionando e removendo uma referência

Para adicionar uma referência em Project

  1. Na barra de menu, escolha Arquivo, Abrir.

  2. Navegar para a sua solução ou projeto.

  3. Em Gerenciador de Soluções, abra o menu de atalho para o nó references, e então escolha Adicionar Referência.

  4. Na caixa de diálogo de Referenciar o gerenciador , especifique as referências para adicionar, e então escolha o botão de OK .

Para remover uma referência, abra o menu de atalho, e então escolha Remover.

Para adicionar uma referência em c++ projeto

  1. Na barra de menu, escolha Arquivo, Abrir.

  2. Navegar para a sua solução ou projeto.

  3. Em Gerenciador de Soluções, abra o menu de atalho para o nó de projeto, e então escolha Referências.

  4. Na caixa de diálogo de Páginas de Propriedade , escolha o botão de Adicionar Nova Referência .

  5. Na caixa de diálogo de Adicionar Referência , especifique as referências para adicionar, e então escolha o botão de OK .

Para remover uma referência, abra o menu de atalho, e então escolha Remover.

Referenciar o gerenciador abre e lista as referências disponíveis pelo grupo.O tipo de projeto determina quais os seguintes grupos aparecem:

  • Assemblies, com os subgrupos de Framework e as extensões.

  • Solução, com o subgrupo de projetos.

  • O Windows, com os subgrupos principal e as extensões.Você pode explorar as referências no Windows SDK ou extensão SDKs usando Pesquisador de Objetos.

  • Procurar, com o subgrupo recente.

Guia de assemblies

O guia de Assemblies lista todos os assemblies do.NET Framework que estão disponíveis para referência.O guia de Assemblies não lista quaisquer módulos (assemblies) da cache global de assemblies (GAC) porque os assemblies no GAC são parte do ambiente de tempo de execução.Se você implantar um aplicativo que contém uma referência a um assembly que está registrado no GAC, o assembly não será implantado com o aplicativo, independentemente da configuração local de impressão.Para obter mais informações, consulte Referências de Project.

Quando você adicionar manualmente uma referência a qualquer namespaces de EnvDTE (EnvDTE, EnvDTE80, EnvDTE90, EnvDTE90a, ou EnvDTE100), defina a propriedade dos tipos de Interoperabilidade inserir de referência como 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.

Todos os projetos da área de trabalho contém uma referência implícita a mscorlib.projetos deVisual Basic contém uma referência implícita. a Microsoft.VisualBasicEm Visual Studio 2012, todos os projetos contêm uma referência implícita a System.Corré, mesmo se removeu a lista de referências.

Se um tipo de projeto não faz assemblies de suporte, a guia não aparecerão na caixa de diálogo do Gerenciador de referência .

O guia de módulos (assemblies) consiste de dois sub-guia:

  1. Listas de Framework todos os assemblies que constituem Framework de destino.

    • Assemblies anunciados estão em Framework completo e são enumerados na lista de Framework quando seu projeto utiliza um perfil de Framework de destino.Assemblies anunciados são cinzentos diferenciá-los de assemblies que existem no perfil de destino de Framework do projeto.Por exemplo, se um projeto utiliza o cliente do .NET Framework 4, a lista de Framework mostra os assemblies anunciados do .NET Framework 4.Quando um usuário adiciona um assembly anunciado, o usuário é notificado, que depois que a caixa de diálogo do Gerenciador de referência é fechada, o projeto retargeted a .NET Framework 4 e o assembly anunciado será adicionado.

    • Projetos de aplicativos Windows Store contém referências a todos os assemblies em .NET para aplicativos da Windows Store de destino por padrão na criação do projeto.Em projetos gerenciados, um nó somente leitura na pasta referências em Gerenciador de Soluções indica a referência a Framework inteiro.Da mesma forma, o guia do Framework não enumerará alguns dos assemblies de Framework e não exibirá em vez da seguinte mensagem: “Todos os assemblies de Framework são referenciados já.Use por favor o pesquisador de objetos para explorar as referências no Framework.” Para projetos de área de trabalho, o guia do Framework enumera os assemblies do Framework de destino, e o usuário deve adicionar referências que o aplicativo requer.

  2. As extensões lista todos os assemblies que fornecedores externos de componentes e controles se tornaram para estender Framework de destino.Dependendo da finalidade do aplicativo do usuário, pode precisar esses assemblies.

    • As extensões são preenchidas enumerando os assemblies que são registrados nos seguintes locais:

      32-bit machine:
      HKEY_CURRENT_USER\SOFTWARE\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
      HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
      64-bit machine:
      HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
      HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
      And older versions of the [Target Framework Identifier]
      

      Por exemplo, se um projeto utiliza o.NET Framework 4 em um computador de 32 bits, as extensões enumerarão os assemblies que estão sob registrado \ Microsoft \ .NETFramework \ \ \ v4.0 AssemblyFoldersEx, \ Microsoft \ .NETFramework \ v3.5 \ AssemblyFoldersEx, \ \ Microsoft \ .NETFramework \ v3.0 \, e AssemblyFoldersEx \ \ Microsoft \ .NETFramework \ v2.0 \ \ AssemblyFoldersEx.

Guia COM

A guia da lista todos os componentes COM que estão disponíveis para referência.Se você deseja adicionar uma referência a uma DLL registrada COM que contém um manifesto interno, cancelar o registro DLL primeiro.Caso contrário, o Visual Studio adiciona a referência de assembly como um controle ActiveX em vez de como uma DLL nativa.

Se um tipo de projeto não suporta COM, o guia não aparecerão na caixa de diálogo do Gerenciador de referência .

Guia de solução

A guia da solução lista todos os projetos compatíveis dentro da solução atual, em sub-guia projetos.

Um projeto pode fazer referência a outro projeto que tem como alvo uma versão diferente do .NET Framework.Por exemplo, você pode criar um projeto que destinassem .NET Framework 4 mas que referencia um assembly compilado para o .NET Framework 2.No entanto, o projeto do .NET Framework 2 não pode fazer referência a um projeto de .NET Framework 4 .Para obter mais informações, consulte Almejando um específico.NET Framework versão ou perfil.

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

Em Visual Studio 2012, uma referência de arquivo em vez de uma referência de projeto é criada se um projeto utiliza o .NET Framework 4 e outro projeto utiliza uma versão anterior.

Um projeto que tem como alvo .NET para aplicativos da Windows Store não pode adicionar uma referência de projeto para um projeto que tem como alvo o .NET Framework e vice-versa.

Guia do Windows

Guia do Windows lista qualquer SDKs que é específico às plataformas que execução nos sistemas operacionais Windows.

Você pode gerar um arquivo de WinMD no Visual Studio de duas maneiras:

  • Windows Store projetos de aplicativos gerenciados: projetos de aplicativo de Windows Store podem acessar binários de WinMD de saída definindo propriedades de Project | Tipo de saída = WinMD Arquivo.O nome de arquivo WinMD deve ser o namespace de superconjunto de quaisquer namespaces que existem nela.Por exemplo, se um projeto consiste nos namespaces A.B e A.B.C, os nomes possíveis para seu WinMD outputted são A.winmd e A.B.winmd.Se um usuário entra em propriedades de Project | Nome de assembly ou propriedades de Project | O valor de namespace que não é separada do conjunto de namespaces no projeto ou há nenhuma namespace de superconjunto em um projeto, um aviso de compilação é gerado: “A.winmd” não é um nome válido de arquivo de .winmd para esse assembly.Todos os tipos em um arquivo de metadados do Windows devem existir em um namespace secundária de nome de arquivo.Tipos que não existe em um namespace secundária de nome de arquivo não poderá ser colocado em tempo de execução.Nesse assembly, o namespace comuns a menor é “CSWSClassLibrary1”.Uma área de trabalho Visual Basic ou o projeto Visual C# só podem consumir WinMDs que é gerado com Windows 8 SDKs, que são conhecidas como a primeira parte WinMDs, e não podem gerar WinMDs.

  • Windows Store projetos de nativo do aplicativo: Um arquivo de WinMD de ambos consiste somente de metadados.A implementação existe em um arquivo separado de DLL.Se pode gerar binários nativos escolhendo o componente modelo de projeto de Tempo de Execução do Windows na caixa de diálogo de Novo Projeto ou inicial de um projeto em branco e modificar as propriedades do projeto para gerar um arquivo de WinMD.Se o projeto consiste separe os namespaces, um erro de compilação dirá o usuário para combinar seus namespaces ou para executar a ferramenta de MSMerge.

Guia do Windows consiste de dois sub-guia.

Hh708954.collapse_all(pt-br,VS.110).gifSubgrupo principal

A principal lista qualquer WinMDs (para elementos de WinRT) no SDK para a versão de destino do Windows.

projetos de aplicativo deWindows Store contêm referências a qualquer WinMDs em Windows 8 SDK por padrão na criação do projeto.Em projetos gerenciados, um nó somente leitura na pasta referências em Gerenciador de Soluções indica a referência a Windows 8 inteiro SDK.Da mesma forma, a principal no gerenciador de referência não enumerará alguns dos assemblies de Windows 8 SDK e não exibe uma mensagem em vez disso: “Windows SDK já é referenciado.Use por favor o pesquisador de objetos para explorar as referências no Windows SDK.”

Em projetos da área de trabalho a guia principal não aparece por padrão.Você pode adicionar Tempo de Execução do Windows abrindo o menu de atalho para o nó de projeto, escolhendo Descarregar projeto, adicionando o seguinte trecho de código, e novamente a abertura o projeto (no nó de projeto escolha Recarregar projeto).Quando você chama a caixa de diálogo Gerenciador de Referência, a guia Principal aparece.

  <PropertyGroup>
    <TargetPlatformVersion>8.0</TargetPlatformVersion>
  </PropertyGroup>

Certifique-se marque a caixa do Windows nesta guia.Então você deve ser capaz de usar os elementos de WinRT.

Hh708954.collapse_all(pt-br,VS.110).gifSubgrupo de extensões

As extensões ao usuário SDKs que estendem a plataforma de destino do Windows.Este guia aparece para projetos de aplicativo de Windows Store somente.Os projetos desktop não mostrarão este guia porque podem consumir somente arquivos de primeira parte .winmd.

O é uma coleção de arquivos que o Visual Studio trata como um único componente.Na guia de extensões, SDKs que se aplica ao projeto de que a caixa de diálogo do Gerenciador de referência foi chamada é listado como únicas entradas.Quando adicionado a um projeto, todo o conteúdo do SDK é consumido pelo Visual Studio para que o usuário não precisará executar qualquer ações adicional aproveitar o conteúdo do IntelliSense, a caixa de ferramentas, designer, pesquisador de objetos, compilação, implantação, depuração, e empacotar.Para obter informações sobre como exibir o SDK nas extensões catalogue, consulte Como: criar um Kit de desenvolvimento de Software.

ObservaçãoObservação

Se um projeto referencia SDK que depende de outro SDK, o Visual Studio não consumirá segundo SDK a menos que o usuário manualmente adicionar uma referência a segunda SDK.Quando um usuário escolher SDK na guia de Extensões , a caixa de diálogo do Gerenciador de referência ajudam a identificar o usuário dependências do SDK listando não apenas o nome e a versão do SDK mas também o nome de todas as dependências do SDK no painel de detalhes.Se um usuário não observa as dependências e não adiciona somente o SDK, MSBuild solicitará que o usuário para adicionar as dependências.

Se um tipo de projeto não suporta Extensões, a guia não aparece na caixa de diálogo do Gerenciador de referência .

Procure o botão

Você pode usar o botão de Procurar para procurar um componente do sistema de arquivos.

Um projeto pode fazer referência a um componente que tem como alvo uma versão diferente do .NET Framework.Por exemplo, você poderia criar um aplicativo que destinasse o perfil de cliente do .NET Framework 4, que faz referência a um componente que tem como alvo o .NET Framework 2.Para obter mais informações, consulte Almejando um específico.NET Framework versão ou perfil.

Você deve evitar adicionar referências de arquivo para saída de outro projeto na mesma solução, porque esta tática pode causar erros de compilação.Em vez disso, use a guia de Solução da caixa de diálogo do Gerenciador de referência para criar referências de Project-à- Project.Esta tática torna desenvolvimento de equipe permitindo melhor gerenciamento de bibliotecas de classes que você cria em seus projetos.Para obter mais informações, consulte Solução de problemas de referências quebradas.

Você não pode procurar a SDK e adicioná-la ao seu projeto.Você só pode procurar por um arquivo (por exemplo, um conjunto ou um .winmd) e o adiciona ao seu projeto.

Ao fazer uma referência a arquivo para um WinMD, o layout é esperado que nome de arquivo [], os .winmd nome de arquivo [] todos os arquivos .dll, e nome de arquivo [] de .pri são colocados ao lado de se.Se você referencia um WinMD nas seguintes situações, um conjunto de arquivos incompleto será copiado para o diretório de saída do projeto e, como consequência, a compilação e falhas de tempo de execução ocorrerão.

  • Componente nativo: um projeto nativo criará um WinMD para cada separa o conjunto de namespaces e de uma DLL que consiste de implementação.O WinMDs terá nomes díspares.Ao fazer referência a esse arquivo componente nativo, MSBuild não reconhecerá que o WinMDs dissimilar chamado torna um componente.Como consequência, somente [] o nome de arquivo .dll mesmo nome e nome de arquivo [] .winmd será copiado, e os erros de tempo de execução ocorrerão.Para resolver esse problema, crie uma extensão SDK.Para obter mais informações, consulte Como: criar um Kit de desenvolvimento de Software.

  • Consumir controles: pelo menos, um controle XAML consiste de nome de arquivo [] [.winmd, nome de arquivo .dll [], nome de arquivo .pri] [], xamlname .xaml, e a imagename .jpg [].Quando o projeto é compilado, arquivos de recursos que são associados com a referência de arquivo não obterão copiado para o diretório de saída do projeto, e somente nome de arquivo [], em .winmd [] nome de arquivo .dll e nome de arquivo [] .pri serão copiados.Um erro de compilação é efetuado logon para informar ao usuário que os recursos xamlname [] [] imagename .xaml e .jpg estão faltando.Para obterá êxito, o usuário terá que copiar esses arquivos de recurso no diretório de saída do projeto para a compilação e depuração/tempo de execução.Para resolver esse problema, crie uma extensão SDK seguindo as etapas em Como: criar um Kit de desenvolvimento de Software ou editar o arquivo de projeto para adicionar a propriedade a seguir:

    <PropertyGroup>
    <GenerateLibraryOutput>True</GenerateLibraryOutput>
    </PropertyGroup>
    
    ObservaçãoObservação

    Se você adiciona a propriedade, a compilação pode mais lento.

Recente

Assemblies COM Windows, e para cada suporte a uma tabulação recente, que enumerar a lista de componentes que tenham sido recentemente adicionados para projetos.

Pesquisa

A barra de pesquisa na caixa de diálogo do Gerenciador de referência opera na guia que está em foco.Por exemplo, se o usuário digitar “sistema” na barra de pesquisa quando a guia da solução está em foco, a pesquisa não irão retornar os resultados a menos que a solução consistir de um nome de projeto que contém o sistema “”.

Consulte também

Tarefas

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

Conceitos

Gerenciando referências do projeto