Solucionar problemas de referências quebradas

  • Artigo

              Aplica-se a: Visual Studio 2022

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

  • O caminho de referência do projeto está incorreto ou incompleto.
  • O arquivo referenciado foi excluído.
  • O arquivo referenciado foi renomeado.
  • Falha na conexão ou autenticação de rede.
  • 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 de vários desenvolvedores podem descobrir que estão faltando um assembly referenciado em seu ambiente local. Para evitar esses erros, é melhor adicionar referências de projeto a projeto. Para obter mais informações, confira Assemblies no .NET.

O caminho de referência está incorreto ou incompleto

Se os projetos forem compartilhados em computadores diferentes, algumas referências poderão não ser encontradas quando um componente estiver localizado em um diretório diferente. As referências são armazenadas sob o 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 encontrar esses arquivos de componentes. 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 será exibido 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 é persistente para cada usuário em cada computador. Portanto, modificar seu caminho de referência não afeta outros usuários do projeto.

Dica

As referências de projeto a projeto não têm esses problemas de referência quebrados. Por esse motivo, use referências project-to-project em vez de referências de arquivo, se puder.

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. Em Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e selecione Propriedades. A Designer do Projeto é exibida.
  2. Se você estiver usando o Visual Basic, selecione a página Referências e 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 você estiver usando 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 referenciado foi excluído

Aqui estão duas opções para corrigir uma referência de projeto quebrada 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 em seu computador, leia-a desse local.

O arquivo referenciado foi renomeado

Aqui estão duas opções para corrigir uma referência quebrada 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 em seu computador, leia-a desse local.

Falha na conexão ou autenticação de rede

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, excluir a referência e corrigir o código que o 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 obter mais informações sobre como usar referências a componentes COM em seus projetos, consulte Interoperabilidade COM em aplicativos .NET Framework.

Referências