Поделиться через

Диагностика неработающих ссылок

  • Статья

Область применения: Visual Studio

Если ваше приложение пытается использовать неработающую ссылку, создается ошибка исключения. Основная причина ошибки заключается в невозможности найти указанный компонент, но существует несколько сценариев, в которых ссылка считается нарушенной, и они:

  • Ссылочный путь проекта является неверным или неполным.
  • Файл, на который ссылается ссылка, был удален.
  • Файл, на который ссылается ссылка, был переименован.
  • Сбой сетевого подключения или проверки подлинности.
  • На компьютере не установлен указанный com-компонент.

В следующих нескольких разделах приводятся решения этих сценариев.

Примечание.

Ссылки на файлы в сборках задаются по абсолютным путям в файле проекта. Поэтому пользователи, работающие в среде с несколькими разработчиками, могут обнаружить, что в локальной среде отсутствует ссылка на сборку. Чтобы избежать этих ошибок, лучше добавить ссылки на project-to-project. Дополнительные сведения см. в разделе "Сборки" в .NET.

Неправильный или неполный путь ссылки

Если проекты совместно используются на разных компьютерах, некоторые ссылки могут не находиться, когда компонент находится в другом каталоге. Ссылки сохраняются под именем файла компонента (например, MyComponent). При добавлении ссылки на проект расположение папки файла компонента (например, C:\MyComponents) добавляется в свойство проекта ReferencePath .

При открытии проекта Visual Studio будет выглядеть в каталогах по пути ссылки, чтобы попытаться найти эти файлы компонентов. Если открыть проект на компьютере, где хранится компонент в другом каталоге, например D:\MyComponents, ссылка не будет найдена, а в списке задач появится ошибка.

Чтобы устранить эту проблему, используйте один из следующих способов:

  • Удалите неработаемую ссылку и замените ее с помощью диалогового окна "Добавить ссылку ".
  • Используйте элемент ссылочного пути на страницах свойств проекта. Измените папки в списке, чтобы указать правильные расположения. Свойство Путь для ссылок сохраняется для каждого пользователя на каждом компьютере. Поэтому изменение пути ссылки не влияет на других пользователей проекта.

Совет

Ссылки на project to-project не имеют этих проблем с неработающей ссылкой. По этой причине используйте ссылки на project-to-project вместо ссылок на файлы, если вы можете.

Исправлена сломанная ссылка на проект

Чтобы исправить сломанную ссылку на проект, исправьте путь к ссылке, выполнив следующие действия:

  1. В Обозреватель решений щелкните правой кнопкой мыши узел проекта и выберите пункт "Свойства". Открывается конструктор проектов.
  2. Если вы используете Visual Basic, выберите страницу "Ссылки " и выберите "Ссылочные пути".
    1. В диалоговом окне "Пути ссылки" введите путь к папке, содержащей элемент, на который нужно ссылаться в поле "Папка".
    2. Выберите " Добавить папку".
  3. Если вы используете C#, выберите страницу ссылочных путей.
    1. В поле "Папка" введите путь к папке, содержащей элемент, на который требуется ссылаться.
    2. Выберите " Добавить папку".

Файл, на который ссылается ссылка, удален

Ниже приведены два варианта исправления сломанной ссылки на проект для удаленного файла, который больше не существует на диске:

  • Удалите ссылку.
  • Если ссылка находится в другом расположении на компьютере, считайте ее оттуда.

Файл, на который ссылается ссылка, переименован

Ниже приведены два варианта исправления сломанной ссылки на файл, который был переименован:

  • Удалите ссылку, а затем добавьте ссылку на переименованный файл.
  • Если ссылка находится в другом расположении на компьютере, считайте ее оттуда.

Сбой подключения к сети или проверки подлинности

Существует множество возможных причин для недоступных файлов. Например, может возникнуть сбой сетевого подключения или сбой проверки подлинности. И наоборот, каждая причина может иметь уникальные средства восстановления. Например, для доступа к необходимым ресурсам может потребоваться обратиться к локальному администратору. Однако удаление ссылки и исправление используемого кода всегда является параметром.

Указанный com-компонент не установлен на компьютере

Если пользователь добавляет ссылку на COM-компонент, а второй пользователь пытается запустить код на компьютере, который не установлен, второй пользователь получает ошибку с неработающей ссылкой. Установка компонента на втором компьютере исправляет ошибку. Дополнительные сведения об использовании ссылок на COM-компоненты в проектах см. в разделе COM-взаимодействие в приложениях .NET Framework.

Ссылки