Практическое руководство. Добавление и удаление ссылок в Visual Studio

  • Статья

Чтобы использовать компонент в приложении, необходимо сначала добавить ссылку на этот компонент. Visual Studio предоставляет пять вариантов в диалоговом окне "Добавить ссылку".

  • .NET — список всех компонентов платформы .NET Framework, ссылки на которые можно добавить.

  • COM — список всех COM-компонентов, ссылки на которые можно добавить.

  • Projects — список всех повторно используемых компонентов, созданных в локальных проектах.

  • Обзор — позволяет осуществлять поиск компонента в файловой системе.

  • Последние — содержит список компонентов, недавно добавленных к проектам на компьютере.

Количество вкладок в диалоговом окне Добавление ссылки меняется в зависимости от типа открытого проекта и используемых им ресурсов. Собственные проекты C++ содержат только вкладку Проекты.

Некоторые компоненты в списке могут не отображаться в зависимости от версии .NET Framework проекта. Это может произойти в следующих случаях.

  • Компонент, использующий новую версию платформы .NET Framework, не совместим с проектом, нацеленным на более раннюю версию платформы .NET Framework.

    Дополнительные сведения об изменении требуемой версии платформы .NET Framework для проекта см. в разделе Практическое руководство. Указание конкретной версии или профиля платформы .NET Framework.

  • Компонент, использующий .NET Framework 4, несовместим с проектом, нацеленным на Клиентский профиль .NET Framework 4.

    При создании нового приложения некоторые проекты нацелены на Клиентский профиль .NET Framework 4 по умолчанию. Дополнительные сведения см. в разделе Профиль клиента .NET Framework.

Невозможно добавить ссылки из глобального кэша сборок, так как это исключительно часть среды выполнения.

При развертывании или копировании приложения, содержащего ссылку на пользовательский компонент, зарегистрированный в глобальном кэше сборок, компонент не будет развернут или скопирован вместе с приложением, вне зависимости от свойства Copy Local. Дополнительные сведения см. в разделе Ссылки проекта.

Разработчики могут создавать приложения, которые ссылаются на проекты или сборки, предназначенные для другой версии платформы .NET Framework. Например, разработчик может создать приложение, предназначенное для Клиентский профиль .NET Framework 4 и ссылающееся на сборку, которая предназначена для .NET Framework 2.0. При создании проекта, предназначенного для более ранней версии .NET Framework, установка в этом проекте ссылки на проект или сборку для Клиентский профиль .NET Framework 4 или для платформы .NET Framework версии 4 невозможна. Дополнительные сведения см. в разделе Указание конкретной версии или профиля платформы .NET Framework.

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

Примечание

В Visual Studio 2010 ссылка на файл создается вместо ссылки на проект, если в качестве требуемой версии платформы .NET Framework одного проекта используется версия 4, а требуемая версия .NET Framework других проектов — 2, 3 или 3.5.

Если необходимо добавить ссылку на зарегистрированный COM DLL, содержащую внутренний манифест, убедитесь, что отменена регистрация библиотеки DLL. Если этого не сделать, среда разработки Visual Studio добавляет ссылку как компонент ActiveX, а не как собственные DLL.

Можно также добавить веб-ссылки с помощью диалогового окна Добавить веб-ссылку. Дополнительные сведения см. в разделе Практическое руководство. Добавление и удаление веб-ссылок.

При добавлении вручную ссылки на любое из пространств имен EnvDTE (EnvDTE, EnvDTE80, EnvDTE90, EnvDTE90a или EnvDTE100) установите в окне свойств для свойства ссылки Внедрить типы взаимодействия значение False. Задание для этого свойства значения True может привести к проблемам построения, так как некоторые свойства EnvDTE не допускают внедрение.

Примечание

Все проекты содержат неявную ссылку на библиотеку mscorlib.Проекты Visual Basic содержат неявную ссылку на Microsoft.VisualBasic.

В Visual Studio 2010 все проекты содержат неявную ссылку на System.Core, даже если System.Core была удалена из списка ссылок.

Чтобы отобразить сборку в диалоговом окне "Добавление ссылки"

  • Переместите или скопируйте сборку в одно из следующих расположений.

    • Каталог текущего проекта. (Можно найти эти сборки, используя вкладку Обзор.)

    • Другие каталоги проектов в одном решении. (Можно найти эти сборки, используя вкладку Проекты.)

    - или -

  • Установите раздел реестра, определяющий положение отображаемых сборок.

    Для 32-разрядной операционной системы добавьте один из следующих разделов реестра.

    • [HKEY_CURRENT_USER\SOFTWARE\Microsoft\.NETFramework\минимальная_версия\AssemblyFoldersEx\MyAssemblies]@="расположение_сборки"

    • [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\минимальная_версия\AssemblyFoldersEx\MyAssemblies]@="расположение_сборки"

    Для 64-разрядной операционной системы добавьте один из следующих разделов реестра в 32-разрядный куст реестра.

    • [HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\минимальная_версия\AssemblyFoldersEx\MyAssemblies]@="расположение_сборки"

    • [HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\минимальная_версия\AssemblyFoldersEx\MyAssemblies]@="расположение_сборки"

    минимальная_версия — это минимальная допустимая версия платформы .NET Framework. Если для минимальная_версия задана версия v3.0, папки, указанные в AssemblyFoldersEx, относятся к проектам, предназначенным для платформы .NET Framework 3.0 и старше.

    расположение_сборки является каталогом сборок, которые требуется отображать в диалоговом окне Добавить ссылку, например C:\MyAssemblies\.

    Создание ключа реестра в узле HKEY_LOCAL_MACHINE позволяет всем пользователям видеть сборки в указанном расположении в диалоговом окне Добавить ссылку. Создание ключа реестра в узле HKEY_CURRENT_USER влияет только на настройки для текущего пользователя.

    Снова откройте диалоговое окно Добавление ссылки. Эти сборки должны отображаться на вкладке .NET. Если это не так, убедитесь, что сборки расположены в указанном каталоге расположение_сборки, перезапустите Visual Studio и повторите попытку.

Чтобы добавить ссылку в Visual Basic

  1. В обозревателе решений дважды щелкните узел проекта Мой проект.

  2. В Конструкторе проектов перейдите на вкладку Ссылки.

  3. Нажмите кнопку Добавить для открытия диалогового окна Добавление ссылки.

  4. В диалоговом окне Добавление ссылки выберите вкладку, соответствующую типу компонента, ссылка на который создается.

  5. Выберите компоненты, на которые надо ссылаться, и нажмите кнопку OK.

    Совет

    Можно выбрать несколько компонентов, удерживая клавишу CTRL, если компоненты находятся на одной вкладке.

Чтобы добавить ссылку в Visual C#

  1. В обозревателе решений щелкните правой кнопкой мыши узел проекта и выберите команду Добавить ссылку.

  2. В диалоговом окне Добавление ссылки выберите вкладку, соответствующую типу компонента, ссылка на который создается.

  3. Выберите компоненты, на которые надо ссылаться, и нажмите кнопку OK.

    Совет

    Можно выбрать несколько компонентов, удерживая клавишу CTRL, если компоненты находятся на одной вкладке.

Чтобы удалить ссылку в Visual Basic

  1. В обозревателе решений дважды щелкните узел проекта Мой проект.

  2. В конструкторе проектов перейдите на вкладку Ссылки.

  3. В списке Ссылки выберите ссылку, которую необходимо удалить.

  4. Нажмите кнопку Удалить.

    Совет

    Можно также проверить проект на неиспользуемые ссылки и удалить их все одновременно.Дополнительные сведения см. в разделе Практическое руководство. Удаление не используемых ссылок (Visual Basic).

Чтобы удалить ссылку в Visual C#

  1. В обозревателе решений откройте узел Ссылки в узле проекта.

  2. Щелкните правой кнопкой мыши ссылку и выберите команду Удалить.

См. также

Задачи

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

Практическое руководство. Добавление или удаление импортированных пространств имен (Visual Basic)

Практическое руководство. Удаление не используемых ссылок (Visual Basic)

Практическое руководство. Установка для ссылки свойства Copy Local

Практическое руководство. Добавление в проект новых элементов

Практическое руководство. Добавление и удаление веб-ссылок

Практическое руководство. Установка пути для ссылки (C#)

Ссылки

Страница "Приложение" в конструкторе проектов (C#)

Диалоговое окно "Дополнительные параметры компилятора" (Visual Basic)

Основные понятия

Ссылки проекта

Веб-ссылки в Visual Studio

Обзор настройки для различных версий в Visual Studio

Устранение неполадок, связанных с настойкой для определенных версий платформы .NET Framework

Другие ресурсы

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

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

Указание конкретной версии или профиля платформы .NET Framework