Compartilhar via

Referências do projeto

  • Artigo

Para escrever código contra um componente externo, seu projeto deve primeiramente conter uma referência a ele.Uma referência pode ser feita aos seguintes tipos de componentes:

  • Bibliotecas de classes do .NET Framework ou assemblies

  • Componentes COM

  • Outros conjuntos de módulos (assemblies) ou bibliotecas de classes de projetos na mesma solução

  • Serviços Web XML

Para obter mais informações sobre referências de XML Web Services, consulte Referências da Web no Visual Studio.

Observação sobre o Visual Basic:

Referências de projeto são gerenciado de forma diferente no Visual Studio que eles eram no Visual Basic 6.0. Para obter mais informações, consulte Gerenciamento de projeto para usuários do Visual Basic 6.0.

Adicionando referências em tempo de design

Use o Caixa de diálogo Add Reference para adicionar referências a componentes em tempo de design.

A caixa de diálogo Referenciar lista conjuntos de módulos (assemblies) nos seguintes locais:

  • A pasta Public Assemblies: Program Files\Microsoft Visual Studio 9.0\Common7\IDE\Public Assemblies.

    Se você copiar outros conjuntos para a pasta Public Assemblies, eles aparecerão na lista da caixa de diálogo Adicionar Referência .

  • Pastas que você especificou definindo os caminhos de referência.

    O procedimento para definir o caminho de referência para projetos Visual C# é ligeiramente diferente.Em um projeto Visual Basic, clique no botão Referência caminhos para exibir a caixa de diálogo Adicionar Referência .Em um projeto Visual C#, use a chave Referência de caminhos Page, Designer de Projeto (C#) do Project Designer .Para obter mais informações, consulte Como: conjunto o caminho de referência (translation from VPE for Csharp).

Você também pode usar a caixa de diálogo Adicionar Referência para procurar conjuntos de módulos (assemblies) não listados.Não é possível adicionar referências de Cache global de assemblies (GAC), pois esta é parte estrita do ambiente de tempo de execução.

Quando você faz uma referência a um conjunto em seu projeto, Visual Studio procura o assembly nos 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) na guia Projects).

  • A pasta Public Assemblies: Program Files\Microsoft Visual Studio 9.0\Common7\IDE\Public Assemblies.(Você pode encontrar esses assemblies na guia .NET).

  • Pastas que você especificou definindo os caminhos de referência.(Você pode definir os caminhos de referência usando o Caixa de diálogo caminhos de referência (Visual Basic) ou o Referência de caminhos Page, Designer de Projeto (C#).)

Para obter mais informações sobre como adicionar referências em tempo de design, consulte Como: Adicionar ou remover referências no Visual Studio (Visual Basic).

Referências a componentes compartilhados em tempo de execução

Em tempo de execução, componentes devem ser no caminho de saída do projeto ou na caixa Cache global de assemblies (GAC).Se o projeto contiver uma referência a um objeto que não esteja em um desses locais, a referência deve ser copiada para o caminho de saída do projeto quando o projeto é criado.A propriedade CopyLocal indica se esta cópia tem a ser feita.Se o valor for True , a referência é copiada para a pasta do projeto ao criar 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 da configuração CopyLocal.Em versões anteriores do Visual Studio, você pode definir a propriedade CopyLocal em uma referência para garantir que o assembly foi implantado.Agora, você deve adicionar manualmente o assembly à 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, a CopyLocal propriedade é conjunto para False se o assembly ou componente está no cache global de assemblies 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.

Referências projeto-a-Projeto e referências de arquivos

Referências de arquivo são referências diretas para conjuntos de módulos (assemblies); você os cria usando a guia Browse da caixa de diálogo Adicionar Referência .Referências projeto-a-projeto são referências a projetos que contenham conjuntos de módulos (assemblies); você cria-los usando a guia Project da caixa de diálogo Adicionar Referência .

A vantagem de uma referência projeto a projeto é que ele cria uma dependência entre os projetos no sistema de compilação.Portanto, o projeto dependente será criado se ele tiver sofrido alterações 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: a dependência 'Arquivo' no projeto 'Projeto' não é possível copiar para o diretório de execução porque ele substituiria a referência 'Arquivo'..

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 Projects da caixa de diálogo Adicionar Referência para criar referências Project-to-project dentro da mesma solução.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 Solucionando Problemas de Referências Quebradas e Como: Criar e remover dependências de projeto.

Referências da Web

Você também pode adicionar referências da Web na caixa de diálogo Add Web Reference.Para obter mais informações, consulte Como: Adicionar e remover referências da Web.

Consulte também

Tarefas

Solucionando Problemas de Referências Quebradas

Como: Adicionar ou remover referências no Visual Studio (Visual Basic)

Referência

Caixa de diálogo Add Reference

Outros recursos

Referenciando Namespaces e Componentes

Gerenciando referências

Programação com assemblies