Дата публикации: 21.06.2017
Обновлено: 26.03.2020

Подключение к базе данных Firebird в Visual Studio 2017 через DDEX провайдер


[UPD 11.04.2019] Эта инструкция совместима с Visual Studio 2019.

[UPD 25.03.2020] Начиная с версии 1.17.0.4032 [R1], инсталлятор может самостоятельно устанавливать и деинсталлировать VSIX пакеты.


Введение

В данном документе рассмотрено конфигурирование DDEX-провайдера для Visual Studio 2017 и Data-провайдера для FW4.6.2.

Вы можете аналогичным образом параллельно установить DDEX-поддержку для Data-провайдеров, откомпилированных для FW4.5.0 и FW4.7.2.

Также возможна установка DDEX провайдеров, привязанных к отладочным сборкам Data провайдеров.

Вы можете просмотреть эту инструкцию на YouTube:

Начальные условия

На компьютере должны быть установлены:

  1. Visual Studio 2017
  2. IBProvider v3 [32bit]

Так же должен быть доступен Firebird SQL Server.

Перед началом работы рекомендуется проверить базу данных на отсутствие ошибок в системных таблицах. В противном случае, могут возникнуть проблемы с генератором запросов. Смотрите инструкцию.

Установка DDEX провайдера и настройка подключения

Скачайте и запустите EXE-инсталлятор ADO.NET провайдера.

Выберите следующие компоненты:

ADO.NET Installer - Main Components Selection

Если нужен Data провайдер для другой версии .NET Framework (к примеру, 4.5 или 4.7.2), выберите её. Если вы хотите использовать отладочный Data провайдер, поставьте галочку возле «Debug».

Нажмите «Далее».

ADO.NET Installer - Additional Components Selection
Проверьте еще раз, что вы выбрали указанные компоненты. В противном случае DDEX провайдер не будет работать или будет работать некорректно!

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

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

После установки в каталоге «c:\Program Files (x86)\LCPI\OleDb.NET\1.8.0\VS2017» будут находится VSIX-файлы для установки DDEX-провайдеров(*):

VSIX файл Платформа Data провайдера Платформа DDEX провайдера
Релизные сборки
lcpi.vs.data.providers.oledb.v2.integrator.vs2017-net4_5_0.net4_6_2.vsix .NET FW v4.5 .NET FW v4.6.2
lcpi.vs.data.providers.oledb.v2.integrator.vs2017-net4_6_2.net4_6_2.vsix .NET FW v4.6.2 .NET FW v4.6.2
lcpi.vs.data.providers.oledb.v2.integrator.vs2017-net4_7_2.net4_7_2.vsix .NET FW v4.7.2 .NET FW v4.7.2
Отладочные сборки
lcpi.vs.data.providers.oledb.v2.integrator.vs2017-net4_5_0.net4_6_2.debug.vsix .NET FW v4.5 .NET FW v4.6.2
lcpi.vs.data.providers.oledb.v2.integrator.vs2017-net4_6_2.net4_6_2.debug.vsix .NET FW v4.6.2 .NET FW v4.6.2
lcpi.vs.data.providers.oledb.v2.integrator.vs2017-net4_7_2.net4_7_2.debug.vsix .NET FW v4.7.2 .NET FW v4.7.2
(*) В вашей установке название папки «1.8.0» и имя vsix-файла могут отличаться. Список файлов зависит от выбранных компонент.

Запустите cmd.exe с правами администратора.

DDEX провайдер устанавливается для всех пользователей системы. Поэтому для его установки требуются права администратора.

Запустите из этой консоли файл «c:\Program Files (x86)\LCPI\OleDb.NET\1.8.0\VS2017\lcpi.vs.data.providers.oledb.v2.integrator.vs2017-net4_6_2.net4_6_2.vsix».

Появится окно установки VSIX:

VSIX Installer. Начало установки

Выполните установку расширения:

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

Настройка подключения

Запустите Visual Studio 2017.

Установленное расширение с DDEX провайдером будет отображаться в списке «Расширения и обновления» Visual Studio:

Диалог со списком расширений Visual Studio

А также в списке установленных продуктов диалога «О программе Microsoft Visual Studio»:

Диалог со сведениями о версии Visual Studio

Откройте окно «Server Explorer» и нажмите кнопку «Подключиться к базе данных». Откроется окно выбора источника данных:

Диалог выбора источника данных

Выберите «Firebird Data Source» и «LCPI поставщик данных .NET Framework для OLE DB [FW4.6.2]». Нажмите «OK».

В открывшемся диалоге настройки подключения укажите основные параметры подключения:

Диалог добавления подключения
Если у вас пустой список с OLE DB провайдерами, то это означает некорректную установку ADO.NET провайдера.

Скорее всего, вы не указали в инсталляторе регистрацию «DB Factories».

Так же, возможно, причина в том, что системный список поставщиков данных ADO.NET содержит устаревшие записи. Проверьте содержимое файла «c:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\Config\machine.config» в секции «system.data».

В некоторых, непонятных случаях, проблема с пустым списком OLE DB провайдеров решается с помощью повторного входа в систему (в крайнем случае — перезагрузкой компьютера).

Теперь нажмите кнопку «Data Links …» и настройте дополнительные параметры:

Data Links. Основная страница настройки подключения
Data Links. Дополнительная страница настройки подключения

Закройте по «OK» диалог «Свойства канала передачи данных» и нажмите кнопку «Проверить подключение»:

Проверка подключения

Закройте по «OK» диалог «Добавить подключение».

В окне «Обозреватель серверов» появится узел «[Firebird].[EMPLOYEE]», который будет связан с базой данных Firebird:

Server Explorer

Деинсталляция DDEX провайдера

1. Запустите Visual Studio 2017 с правами администратора.

2. Выберите в меню «Средства->Расширения и обновления …».

3. Найдите в Списке «LCPI Data OLE DB Integration [FB4.6.2]».

4. Нажмите «Удалить».

5. В появившемся диалоге нажмите «Да».

6. Нажмите в диалоге на кнопку «Закрыть».

7. Закройте Visual Studio.

8. Должен появиться диалог модификации Visual Studio «VSIX Installer».

9. Нажмите «Изменить».

10. Дождитесь завершения процесса.


Дата публикации: 21.06.2017. Права на материал принадлежат: IBProvider. При перепечатке ссылка на сайт https://www.ibprovider.com/rus обязательна.