Устранение неполадок с неисправыми ссылками

  • Статья

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

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

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

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

Примечание.

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

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

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

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

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

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

Совет

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

Исправление неработающие ссылки на проект

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

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

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

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

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

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

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

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

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

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

Компонент COM, на который ссылается ссылка, не установлен на компьютере

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

Ссылки