Как подключиться к встраиваемой базе данных VistaDB

15.11.2019

База данных Vista относится к типу встраиваемых баз. Эти базы отличаются от клиент серверных СУБД тем, что предназначены для встраивания в клиентское приложение в виде файла. Круг задач такой базы также отличается от СУБД. Как правило, это базы которые используются только в одном приложении и не предназначены для совместного использования.  Таким образом VistaDB встает в один ряд с SQLite и SQL Ce.

Рассмотрим, как создать подключение к такой базе данных внутри отчета. Для этого нам потребуется подключить к дизайнеру отчета плагин-коннектор, расположенный в папке:

C:\Program Files (x86)\FastReports\FastReport.Net\Extras\Connections\FastReport.VistaDB

Итогом сборки этого проекта будет библиотека FastReport.VistaDB.dll.

Открываем дизайнер отчета, меню File->Options:

 

На вкладке Plugins добавляем ссылку на созданную нами ранее библиотеку FastReport.VistaDB.dll. После этого перезапускаем дизайнер отчетов.

Добавляем новый источник данных в отчет. При создании подключения, выбираем доступную теперь VistaDB connection:

 

Настройка подключения сводится к выбору файла базы данных и вводу пароля к ней, если задан.

Далее переходим к выбору таблиц:

 

Тут мы можем выбрать таблицу и завершить создание источника данных. Однако, есть возможность отфильтровать данные с помощью SQL запроса. Для этого нажимаем кнопку “Add SQL query…”.

Задаем имя представления данных, которое появится в списке таблиц после создания запроса:

 

Пишем сам SQL запрос:

 

Тут мы использовали параметризированный запрос. Сам параметр мы объявим на следующем шаге мастера создания запроса:

 

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

 

Мы использовали в качестве значения параметра запроса параметр отчета:

 

В итоге мы получим  следующие данные:

Использование плагина для подключения к VistaDB облегчает и ускоряет процесс создания источника данных, а использование параметризированного запроса для фильтрации данных позволяет передать в фильтр значение параметра извне отчета (используя код приложения или через URL).

.NET FastReport Connection База данных .NET FastReport Connection База данных
11 марта 2025

Как использовать FastReport .NET Avalonia на Fedora Workstation с протоколом Wayland

В данной статье мы разберем, как запустить FastReport .NET Avalonia на операционной системе «Fedora Workstation 39» с протоколом Wayland.
7 марта 2025

Как создать QR-код с картинкой в FastReport .NET

В статье разобрались как вставлять картинку в QR Code из дизайнера отчётов FastReport .NET всего за пару кликов.
20 февраля 2025

Использование матричных принтеров для печати чеков

В этой статье мы рассмотрим, как интегрировать матричный принтер в процесс создания и вывода отчетов с использованием FastReport .NET.