Пошаговое руководство. Использование источника данных базы данных с элементом управления ReportViewer для Windows Forms в режиме локальной обработки
В этом пошаговом руководстве показано, как создать отчет в проекте приложения Windows Forms и добавить элемент управления ReportViewer на форму Windows Forms, чтобы пользователи приложения могли просмотреть отчет.
Предварительные требования
Для использования этого пошагового руководства необходим доступ к образцу базы данных AdventureWorks2008.Дополнительные сведения см. в разделе Пошаговое руководство. Установка базы данных AdventureWorks
Чтобы добавить отчет к проекту приложения Windows Forms, выполните следующие действия.Для этого примера приложение создается на Microsoft Visual Basic.
Создание нового проекта приложения Windows
Откройте среду Visual Studio.В меню Файл последовательно выберите команды Создать и Проект.
На панели Установленные шаблоны выберите Visual Basic, затем выберите Приложение Windows Forms.Узел Visual Basic может находиться под узлом Другие языки, в зависимости от начальных настроек Visual Studio.
В поле Name введите имя проекта: ReportWalkthrough.
В поле Расположение введите путь к каталогу, где будет сохранен проект, или нажмите кнопку Обзор, чтобы перейти в эту папку.
Нажмите кнопку ОК.
Откроется конструктор Windows Forms, отображая форму Form1.vb созданного проекта.
Определение соединения с источником данных и объекта DataTable
В меню Проект выберите пункт Добавить новый элемент.
В окне Добавление нового элемента выберите пункт Набор данных.
Введите имя набора данных и нажмите кнопку Добавить.В результате в проект будет добавлен новый файл схемы XML и откроется конструктор наборов данных.Имя по умолчанию — DataSet1.xsd.
В конструкторе наборов данных откройте область элементов и перетащите элемент управления TableAdapter в область конструктора набора данных.Запустится мастер настройки TableAdapter.
На странице «Выбор соединения к данным» нажмите кнопку Создать соединение.
Если источник данных в Visual Studio создается впервые, откроется страница Выбор источника данных.В поле Источник данных выберите значение Microsoft SQL Server.
На странице Добавление соединения выполните следующие шаги.
В поле Имя сервера введите сервер, где расположена база данных AdventureWorks2008.
Экземпляр SQL Server Express по умолчанию имеет имя (local)\sqlexpress.
В разделе Вход на сервер выберите параметр, который обеспечит доступ к этим данным.По умолчанию выбран параметр Использовать проверку подлинности Windows.
Из раскрывающегося списка выберите пункт AdventureWorks2008.
Нажмите кнопку ОК, чтобы вернуться в мастер.
Если на предыдущем шаге вы указали Использовать аутентификацию SQL Server, выберите параметр, задающий, включать конфиденциальные данные в строку или задать информацию в коде приложения.
Нажмите кнопку Далее.
На странице Сохранение строки подключения в файл конфигурации приложения введите имя строки подключения или подтвердите имя по умолчанию — AdventureWorks2008ConnectionString.Нажмите кнопку Далее.
На странице Выбор типа команд выберите Использовать инструкции SQL и затем нажмите кнопку Далее.
На странице Ввод инструкции SQL введите следующий запрос Transact-SQL, чтобы получить данные из базы данных AdventureWorks2008, а затем нажмите кнопку Готово.
SELECT d.name as Dept, s.Name as Shift, e.BusinessEntityID as EmployeeID FROM (HumanResources.Department d INNER JOIN HumanResources.EmployeeDepartmentHistory e ON d.DepartmentID = e.DepartmentID) INNER JOIN HumanResources.Shift s ON e.ShiftID = s.ShiftID
Также можно нажать кнопку Построитель запросов, чтобы использовать построитель запросов для создания запроса и его проверки с помощью кнопки Выполнить запрос.Если запрос не возвращает ожидавшиеся данные, возможно, используется более ранняя версия AdventureWorks.Дополнительные сведения об установке версии AdventureWorks2008 для AdventureWorks см. в разделе Пошаговое руководство. Установка базы данных AdventureWorks.
На странице Выбор методов для создания выберите Готово.
В области конструктора наборов данных должен появиться объект DataTable1 со столбцами, полученными в результате запроса.
Конструирование отчетов с помощью мастера отчетов
В меню Проект выберите пункт Добавить новый элемент.
В окне Добавление нового элемента выберите Мастер отчетов.
Введите имя файла отчета.По умолчанию используется имя отчета Report1.rdlc.Нажмите кнопку Добавить.
Будет запущен мастер отчетов.
На странице Свойства набора данных в списке Источник данных выберите созданный Набор данных.
Окно Доступные наборы данных автоматически будет обновлено добавлением созданного набора DataTable.
Нажмите кнопку Далее.
На странице Упорядочение полей выполните следующие действия.
Перетащите Dept из окна Доступные поля в окно Группы строк.
Перетащите Shift из окна Доступные поля в окно Группы столбцов.
Перетащите EmployeeID из окна Доступные поля в окно Значения.
Щелкните стрелку рядом с Sum(EmplyeeID) и выберите Считать.
Дважды щелкните Далее, затем щелкните Готово.
Будет создан RDLC-файл, который откроется в конструкторе отчетов.Сконструированный табликс теперь отобразится в области конструирования.
Сохраните файл RDLC.
Добавление элемента управления ReportViewer в приложение
Откройте файл Form1.vb в проекте в режиме конструктора.
В окне свойств Форма разверните свойство Size и установите свойство Height в значение 700.
Перетащите элемент управления ReportViewer из раздела Отчет области элементов на форму.
Откройте панель смарт-тегов в элементе управления ReportViewer, щелкнув глиф смарт-тега в правом верхнем углу.Щелкните раскрывающийся список Выбор отчета и выберите созданный отчет.После выбора отчета автоматически создаются экземпляры источников данных, используемых в отчете.Формируется код для создания экземпляра DataSet (контейнера ADO.NET для DataTable), компонента TableAdapter и объекта BindingSource, соответствующего каждому источнику данных в отчете.
Щелкните элемент Закрепление в родительском контейнере на открытой панели смарт-тегов.
Построение и запуск приложения
В меню Построить выберите пункт Построить ReportWalkthrough.В процессе построения компилируется отчет.Все обнаруженные ошибки (в том числе синтаксические ошибки в выражениях, используемых в отчете) добавляются в Список задач.
Нажмите клавишу F5, чтобы запустить приложение и просмотреть отчет на форме.
См. также
Справочник
LocalReport.SubreportProcessing
LocalReport.SubreportProcessing
Основные понятия
Использование панели смарт-тегов для задач ReportViewer