Обновление и повторная привязка ссылок на источники данных (конструктор отчетов Visual Studio)
Элемент управления ReportViewer и файл определения клиентского отчета (с расширением RDLC) содержат ссылки на источники данных, из которых отчет получает данные. При преобразовании определения отчета, добавлении, удалении или изменении набора данных, используемого отчетом, нужно обновить все ссылки на источники данных и привязки к источникам данных до развертывания и запуска приложения.
Общие сведения о ссылках на источники данных, используемых элементами управления ReportViewer и отчетами
Элементы управления и отчеты используют информацию об источнике данных несколькими способами. Во-первых, определение отчета использует внедренную информацию о схеме для создания взаимосвязей между элементами макета отчета и данными, которые, в конце концов, встраиваются в этот макет. Во-вторых, элемент управления ReportViewer требует привязки к источникам данных, чтобы можно было передавать данные во время выполнения.
Во время выполнения все привязки и информация об источниках данных должны быть синхронизированы, чтобы в отчете появились ожидаемые данные. Существует несколько способов, помогающих поддерживать синхронизацию информации об источниках данных во время всего цикла разработки при изменении отчетов и наборов данных, используемых в приложении. В следующем списке перечислены доступные способы.
Использовать задачу Выбрать источники данных в панели смарт-тегов задач элемента управления ReportViewer для привязки источника данных к файлу определения клиентского отчета (с расширением RDLC), преобразованного из файла определения серверного отчета (с расширением RDL).
Использовать задачу Повторно привязать источники данных в панели смарт-тегов задач элемента управления ReportViewer для синхронизации элемента управления и определения отчета с измененными наборами данных.
Использовать диалоговое окно Источники данных для отчета в меню «Отчет» для обновления информации схемы, хранимой в файле определения отчета. Меню «Отчет» становится доступным при изменении файла определения клиентского отчета (с расширением RDLC) в графическом режиме конструктора.
Обновление ссылок на источники данных в определении отчета
Определение отчета включает в себя элементы набора данных, определяющие структуру источника данных, используемого отчетом. Элементы набора данных добавляются к определению отчета во время разработки. Новый элемент добавляется при каждом перетаскивании поля в область данных или текстовое поле отчета.
Обновлять определение отчета необходимо при копировании файлов определений отчетов из одного проекта в другой, если у этих проектов разные источники данных или если наборы данных, используемые в этом проекте, были изменены. Если впоследствии первоначальный набор данных в проекте был изменен (удалены или переименованы поля или таблицы), ссылки, содержащиеся в определении отчета, становятся ошибочными. Обновить определение отчета можно в диалоговом окне Источники данных, как описано в следующих шагах.
Обновление ссылок в определении отчета
Откройте клиентский RDLC-файл в режиме графического конструктора.
В меню «Отчет» выберите пункт Источники данных. Появится диалоговое окно «Источники данных отчета». Доступны следующие режимы.
Чтобы добавить новый набор данных к определению отчета, выберите источник данных проекта и щелкните Добавить в отчет. В большинстве случаев это необязательно. Источники данных проекта добавляются к определению отчета автоматически при перетаскивании полей в макет отчета.
Чтобы удалить из определения отчета существующую ссылку на набор данных, выделите этот набор, а затем нажмите кнопку Удалить.
Если набор данных в проекте был переименован, можно обновить его имя в определении отчета с помощью диалогового окна «Источники данных отчета». Нажмите кнопку Переименовать, чтобы изменить имя набора данных на новое, и введите новое имя.
Нажмите кнопку Обновить все для применения введенных изменений к файлу определения отчета.
Повторная привязка источников данных к элементу управления ReportViewer
Элемент управления ReportViewer требует привязки к данным для получения доступа к источникам данных приложения во время выполнения. Привязки к данным для элемента управления создаются при выборе файла определения клиентского отчета (с расширением RDLC).
Повторная привязка источника данных нужна после изменения определения отчета, который уже был привязан к элементу управления, если набор данных был изменен уже после привязки элемента управления к форме или веб-странице либо при добавлении в отчет нового набора данных. Во всех описанных ситуациях привязки становятся недействительными. Для обновления привязки данных в коде приложения можно использовать задачу Повторно привязать источники данных в панели смарт-тегов задач элемента управления ReportViewer.
.gif "Note") Примечание. |
|---|
Некоторые изменения определения отчета не требуют повторной привязки к источнику данных. Изменение расположения элементов отчета, форматирование элементов отчета и повторное использование одного и того же поля, привязанного к данным, в нескольких областях данных — это примеры изменений, которые не делают недействительными существующие привязки данных. Подобным же образом обновление привязок не требуется при изменении части источника данных, не используемой в отчете. |
Повторная привязка источников данных
Откройте форму или веб-страницу, содержащую элемент управления ReportViewer.
В панели смарт-тегов задач элемента управления ReportViewer щелкните элемент Повторно привязать источники данных. Можно просмотреть фоновый код формы или страницы, чтобы подтвердить изменения.
Выбор источников данных для элемента управления ReportViewer
При преобразовании файла определения серверного отчета (с расширением RDL) в файл определения клиентского отчета (с расширением RDLC) следует удостовериться, что в приложение включен программный код для привязки данных к элементу управления ReportViewer. Код для привязки данных создается автоматически при создании RDLC-файла из шаблона отчета. Однако при создании RDLC-файла любым другим способом код привязки данных отсутствует. Для добавления программного кода привязки данных в приложение можно использовать задачу Выбрать источники данных в панели смарт-тегов задач элемента управления ReportViewer. Дополнительные сведения о преобразовании определений отчетов см. в разделе Преобразование RDL-файлов и RDLC-файлов.
Добавление привязки к источникам данным
Откройте форму или веб-страницу, содержащую элемент управления ReportViewer.
В панели смарт-тегов задач элемента управления ReportViewer щелкните элемент Выбрать источники данных. Можно просмотреть фоновый код формы или страницы, чтобы подтвердить изменения.
См. также
Понятия
Создание клиентских RDLC-файлов
Создание источников данных для отчета
Использование панели смарт-тегов для задач ReportViewer
Настройка ReportViewer для локальной обработки