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

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

Применимо к: Visual Studio

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

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

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

Примечание.

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

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

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

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

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

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

Совет

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ссылки