Реализация класса подключения для модуля обработки данных

Объект Connection представляет подключение к базе данных или аналогичный ресурс и является отправной точкой для пользователей модуля обработки данных SQL Server Reporting Services. Он представляет подключения к серверам баз данных, хотя любая сущность с аналогичным поведением может быть представлена как подключение.

Чтобы реализовать объект Connection , создайте класс, реализующий IDbConnection и при необходимости реализующий IDbConnectionExtension.

В реализации необходимо убедиться, что подключение создается и открывается перед выполнением команд. Убедитесь, что реализация требует от клиентов явного открытия и закрытия подключений, а не открытия и закрытия неявных подключений для клиента. Выполните проверки безопасности при получении подключения. Требование существующего подключения для других классов в модулем обработки данных SSRS гарантирует, что проверки безопасности всегда выполняются при работе с источником данных.

Свойства требуемого соединения представлены в виде строки подключения. Настоятельно рекомендуется, чтобы модули обработки данных SSRS поддерживали ConnectionString свойство с помощью знакомой системы пары имен и значений, определенной OLE DB.

Замечание

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

IDbConnection наследует от IExtension. Интерфейс необходимо реализовать IExtension в рамках реализации класса подключения. Интерфейс IExtension позволяет классу реализовать локализованное имя расширения и обрабатывать сведения о конфигурации расширения, хранящиеся в файле конфигурации служб Reporting Services.

Объект Connection содержит LocalizedName свойство через его реализацию IExtension. Настоятельно рекомендуется поддерживать LocalizedName модули обработки данных служб Reporting Services, чтобы пользователи столкнулись с знакомым локализованным именем расширения в пользовательском интерфейсе, например диспетчером отчетов.

IExtension также позволяет объекту Connection извлекать и обрабатывать пользовательские данные конфигурации, хранящиеся в файле RSReportServer.config. Дополнительные сведения об обработке пользовательских данных конфигурации см. в методе SetConfiguration .

Класс, который реализуется IExtension , не выгружается из памяти при выгрузке остальных классов модуля обработки данных. Из-за этого класс Extension можно использовать для хранения сведений о состоянии между подключениями или хранения данных, которые можно кэшировать в памяти. Класс extension остается в памяти до тех пор, пока сервер отчетов запущен.

Класс Connection можно расширить, чтобы включить поддержку учетных данных в службах Reporting Services, реализуя IDbConnectionExtension. При реализации IntegratedSecurityи UserNameсвойств интерфейса установите флажок встроенной безопасности и Password текстовые поля имени пользователя и пароля диалогового IDbConnectionExtension окна источника данных в конструкторе отчетов. Это позволяет конструктору отчетов хранить и извлекать учетные данные для источников данных, поддерживающих проверку подлинности. Учетные данные хранятся безопасно и используются при отрисовке отчетов в режиме предварительной версии.

Замечание

Реализация IDbConnectionExtension неявно требует реализации элементов IDbConnection и IExtension интерфейсов.

Пример реализации класса Connection см. в примерах продуктов СЛУЖБ SQL Server Reporting Services.

См. также

Расширения служб Reporting Services
Реализация модуля обработки данных
Библиотека расширений служб Reporting Services