Solucionando Problemas de Referências Quebradas
Se seu aplicativo tentar usar uma referência quebrada, um erro de exceção é gerado.A incapacidade de localizar o componente referenciado é o disparador primário do erro, mas existem várias situações em que uma referência pode ser considerada quebrada.Essas instâncias são mostradas na lista a seguir:
O caminho de referência do projeto está incorreto ou incompleto.
O arquivo sendo referenciado foi excluído.
O arquivo sendo referenciado foi renomeado.
A conexão de rede ou a autenticação falhou.
A referência é a um componente COM que não está instalado no computador.
A seguir estão soluções para esses problemas.
.gif "Observação") Observação: |
|---|
Arquivos em assemblies são referenciados com caminhos absolutos no arquivo de projeto.Portanto, é possível que os usuários que trabalham em um multid eveloper ambiente estar faltando um assembly referenciado em seu ambiente local.Para evitar esses erros, é melhor nesses casos adicionar referências de projeto-a-projeto.Para obter mais informações, consulte Como: Adicionar ou remover referências no Visual Studio (Visual Basic) e Programação com assemblies. |
Caminho de referência está incorreto
Se projetos são compartilhados em computadores diferentes, algumas referências podem não ser encontradas quando um componente está localizado em um diretório diferente em cada computador.Referências são armazenadas sob o nome do arquivo de componente (por exemplo, MeuComponente).Quando uma referência é adicionada a um projeto, o local da pasta do arquivo de componente (por exemplo, C:\MeusComponentes\) será acrescentado à propriedade de projeto ReferencePath.
Quando o projeto é aberto, ele tenta localizar esses arquivos de componentes referenciados procurando nos diretórios no caminho de referência.Se o projeto for aberto em um computador que armazena o componente em um diretório diferente, como D:\MeusComponentes\, a referência não poderá ser encontrada e um erro aparecerá na Lista de Tarefas.
Para corrigir este problema, você pode excluir a referência quebrada e substituí-la usando a Caixa de diálogo Add Reference.Uma outra solução é usar o item Reference Path em páginas de propriedades do projeto e modificar as pastas na lista para apontar para os locais correto.A propriedade de caminho de referência é mantida para cada usuário em cada computador.Portanto, modificar o caminho de referência não afeta outros usuários do projeto.
| Dica: |
|---|
Referências de projeto-a-projeto não têm esses problemas.Por esse motivo, use-los em vez de referências de arquivo, se possível . |
Para consertar uma referência de projeto quebrada corrigindo o caminho de referência
No Solution Explorer, clique com o botão direito do mouse no nó do seu projeto e clique em Properties.
O Project Designer aparecerá.
Se você estiver usando o Visual Basic, selecione a página References e clique no botão Reference Paths.Na caixa de diálogo Reference Paths, digite o caminho da pasta que contém o item que você deseja referenciar no campo Folder, depois clique no botão Add Folder.
- ou -
Se você estiver usando o Visual C#, selecione a página Reference Paths.No campo Folder, digite o caminho da pasta que contém o item que você deseja referênciar, e depois clique no botão Add Folder.
Arquivo referenciado foi excluído
É possível que o arquivo sendo referenciado tenha sido excluído e não exista mais na unidade.
Para corrigir uma referência de projeto quebrada a um arquivo que não existe mais no seu disco
Excluir a referência.
Se a referência existir em outro local no seu computador, leia-a deste local.
Para obter mais informações, consulte Como: Adicionar ou remover referências no Visual Studio (Visual Basic).
Arquivo referenciado foi renomeado
É possível que o arquivo referenciado tenha sido renomeado.
Para corrigir uma referência quebrada a um arquivo que foi renomeado
Exclua a referência, e depois adicione uma referência ao arquivo renomeado.
Se a referência existir em outro local no seu computador, você precisa lê-la daquele local.Para obter mais informações, consulte Como: Adicionar ou remover referências no Visual Studio (Visual Basic).
Conexão de rede ou autenticação falhou
Pode haver várias causas possíveis para arquivos inacessíveis: uma conexão de rede que falhou ou uma autenticação com falha, por exemplo.Cada causa pode ter meios exclusivos de recuperação; por exemplo, você pode precisar entrar em contato com o seu administrador local para obter acesso aos recursos necessários.No entanto, excluir a referência e corrigir o código que a usa é sempre uma opção.Para obter mais informações, consulte Como: Adicionar ou remover referências no Visual Studio (Visual Basic).
Componente COM não está instalado no computador
Se um usuário tiver adicionado uma referência a um componente COM e um segundo usuário tentar executar o código em um computador que não tenha este componente instalado, o segundo usuário receberá um erro de que a referência está quebrada.Instalar o componente no segundo computador irá corrigir o erro.Para obter mais informações sobre como usar referências a componentes COM em seus projetos, consulte Interoperabilidade COM em aplicativos .NET Framework.
Consulte também
Tarefas
Como: Adicionar ou remover referências no Visual Studio (Visual Basic)
Referência
Caixa de diálogo Add Reference