Partilhar via


Solução de problemas de referências desfeitas

Aplica-se a: Visual Studio

Se o aplicativo tentar usar uma referência desfeita, um erro de exceção será gerado. O principal motivo do erro é a incapacidade de encontrar o componente referenciado, mas existem vários cenários em que uma referência é considerada quebrada e são eles:

  • O caminho de referência do projeto está incorreto ou incompleto.
  • O arquivo referenciado foi excluído.
  • O arquivo referenciado foi renomeado.
  • A conexão de rede ou autenticação falhou.
  • O componente COM referenciado não está instalado no computador.

As próximas seções fornecem resoluções para esses cenários.

Observação

Os arquivos em assemblies são referenciados com caminhos absolutos no arquivo de projeto. Portanto, os usuários que trabalham em um ambiente com vários desenvolvedores pode verificar que está faltando um assembly de referência no ambiente local. Para evitar esses erros, é melhor adicionar referências projeto a projeto. Para obter mais informações, consulte Assemblies no .NET.

O caminho de referência está incorreto ou incompleto

Se os projetos forem compartilhados em computadores diferentes, algumas referências podem não ser encontradas quando um componente estiver localizado em um diretório diferente. As referências são armazenadas no nome do arquivo de componente (por exemplo, MyComponent). Quando você adiciona uma referência a um projeto, o local da pasta do arquivo de componente (por exemplo, C:\MyComponents) é acrescentado à propriedade do projeto ReferencePath .

Quando você abre um projeto, o Visual Studio examina os diretórios no caminho de referência para tentar localizar esses arquivos de componente. Se você abrir o projeto em um computador que armazena o componente em um diretório diferente, como D:\MyComponents, a referência não será encontrada e um erro aparecerá na Lista de Tarefas.

Para corrigir esse problema, use um dos seguintes métodos:

  • Exclua a referência quebrada e substitua-a usando a caixa de diálogo Adicionar Referência .
  • Use o item Caminho de referência nas páginas de propriedades do projeto. Modifique as pastas na lista para apontar para os locais corretos. A propriedade Caminho de Referência é persistida para cada usuário em cada computador. Portanto, a modificação do caminho de referência não afeta outros usuários do projeto.

Dica

As referências projeto a projeto não têm esses problemas de referência quebrados. Por esse motivo, use referências de projeto para projeto em vez de referências de arquivo, se possível.

Corrigir uma referência de projeto quebrada

Para corrigir uma referência de projeto quebrada, corrija o caminho de referência seguindo estas etapas:

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e, em seguida, selecione Propriedades. O Designer de Projeto é exibido.
  2. Se você estiver usando o Visual Basic, selecione a página Referências e, em seguida, selecione Caminhos de Referência .
    1. Na caixa de diálogo Caminhos de Referência, digite o caminho da pasta que contém o item que você deseja referenciar no campo Pasta.
    2. Selecione Adicionar pasta.
  3. Se estiver usando o C#, selecione a página Caminhos de Referência.
    1. No campo Pasta, digite o caminho da pasta que contém o item que você deseja referenciar.
    2. Selecione Adicionar pasta.

O arquivo de referência foi excluído

Veja aqui duas opções para corrigir uma referência de projeto desfeita para um arquivo excluído que não existe mais em sua unidade:

  • Exclua a referência.
  • Se a referência existir em outro local do computador, leia-a nesse local.

O arquivo de referência foi renomeado

Veja aqui duas opções para corrigir uma referência interrompida para um arquivo que foi renomeado:

  • Exclua a referência e adicione uma referência ao arquivo renomeado.
  • Se a referência existir em outro local do computador, leia-a nesse local.

A conexão de rede ou a autenticação falhou

Pode haver muitas causas possíveis para arquivos inacessíveis. Por exemplo, pode haver uma conexão de rede com falha ou uma autenticação com falha. Por outro lado, cada causa pode ter um meio exclusivo de recuperação. Por exemplo, talvez seja necessário entrar em contato com o administrador local para acessar os recursos necessários. No entanto, a exclusão da referência e a correção do código que a usou é sempre uma opção.

O componente COM referenciado não está instalado no computador

Se um usuário adicionar uma referência a um componente COM e um segundo usuário tentar executar o código em um computador que não tenha esse componente instalado, o segundo usuário receberá um erro de referência quebrado. Instalar o componente no segundo computador corrige o erro. Para saber mais sobre como usar referências a componentes COM nos projetos, veja Interoperabilidade COM em aplicativos .NET Framework.

Referências