Как добавить плагин-коннектор к Oracle в FastReport.NET

Возможно вы еще ни разу не пользовались плагинами для дизайнера отчетов FastReport .NET. Тогда эта статья для вас. Как вы знаете, чтобы отобразить данные из базы в отчете, необходимо создать подключение к источнику данных. Сделать это можно в коде пользовательского приложения или внутри самого отчета. В первом случае вам придется создать подключение, передать его в отчет и зарегистрировать в отчете. Не самый быстрый способ. Гораздо быстрее подключиться к данным внутри отчета. Хотя, если вы создаете много отчетов с подключением к одному и тому же источнику данных все же предпочтительнее первый способ. Но в рамках этой статьи мы поговорим о втором.

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

1) В поставке FastReport .NET есть целый набор плагинов с коннекторами к различным базам данных. Но нас интересует этот: C:\Program Files (x86)\FastReports\FastReport.Net\Extras\Connections\FastReport.Oracle. Открываем решение. ПО умолчанию проект настроен на .NET Framework 2.0. Нужно переключить его на что-то посвежее, например 4.5. Иначе будут проблемы с библиотекой FastReport.

Проверьте ссылки проекта. Вам нужно обновить ссылку на библиотеку FastReport.dll, которую вы найдете в этой папке: C:\Program Files (x86)\FastReports\FastReport.Net.

Вот и все. Строим решение и получаем библиотеку FastReport.Oracle.dll в папке Release.

2) Открываем дизайнер отчетов. Чтобы добавить новый плагин выберите меню Файл - Настройки (File - Options).

С помощью кнопки Add добавляем собранную нами ранее библиотеку. Чтобы изменения вступили в силу нужно перезапустить дизайнер.

Существует еще два способа добавить плагин в дизайнер.

1. Вы можете отредактировать файл конфига дизайнера FastReport.config, который хранится по этому пути:

C:\Documents and Settings\user_name\Local Settings\Application Data\FastReport.

Файл конфигурации представляет собой XML документ. Нас интересует секция Plugins; в которую нужно добавить новый плагин:

1
2
3

< Plugins >
 < Plugin Name="c:\.....\FastReport.Oracle.dll"/ >
 < /Plugins >

2. Из кода пользовательского приложения нужно однократно зарегистрировать новый коннекшн:

FastReport.Utils.RegisteredObjects.AddConnection(typeof(OracleDataConnection));

Предварительно, конечно, нужно добавить ссылку на FastReport.Oracle.dll в проект.

Теперь можно добавить новый источник данных в отчет.

Нажимаем New connection:

Выбираем тип подключения Oracle connection. Заполняем поля: имя сервера, имя пользователя и пароль.

Нажимаем Ок. Затем, выбираем нужные для отчета таблицы. В итоге получаем источник данных в окне справа сверху:

На этом все. Мы получили данные из базы Oracle, воспользовавшись плагином-коннектором. Теперь новый коннектов всегда будет доступен в списке выпора типа подключения. По крайней мере до тех пор, пока вы не удалите плагин в настройках дизайнера, конечно.