Использование контрола ReportViewer в Windows приложниях
Аннотация: Данная статья написана после неудачной попытки быстро создать отчет, используя контрол ReportViewer. Поиски по нашему и зарубежному интернету, при всем обилии ссылок, не дали основного - методики использования. Пользуясь крупицами, которые нашел и не воспроизводимом примером из MSDN, мне, кажется, я смог привести в систему использование данного контрола. Материал сырой, и я буду благодарен за замечания. Если будут отличные от данного решения или уточнения и добавления - пишите - за Вашим авторством добавлю к материалу данной статьи.
Параграф 1. Вместо предисловия
Параграф 2. Источник данных
Параграф 3. Создание проекта решения
Параграф 4. Источник данных для отображения
Параграф 5. Отображение данных
Параграф 6. Упрощенный способ отображения данных
Параграф 7. Использование одного ReportEmbeddedResource для вывода различных отчетов
Параграф 1. Вместо предисловия
Элемент управления ReportViewer - это элемент управления среды Visual Studio, который можно добавить на веб-страницу в проекте решения ASP.NET или в форму приложения Windows. Этот элемент управления включает возможности обработки и просмотра отчетов непосредственно в приложении. ReportViewer - это элемент управления, который, начиная с Visial Studio 2005, представленный контролом. Иначе, это, в отличии от Crystal Report Viewer, бесплатный редактор отчетов, который автоматически встраивается в среду Visual Web Developer 2005 Express.
По существу, ReportViewer является наиболее мощным добавлением к таким элементам управления как, GridView, DataList, DetailsView, FormView, Repeater. В ReportViewer отчёты можно создавать с помощью технологии "drag-and-drop" внутри Дизайнера Отчётов (Report Designer), входящего в среду разработки Visual Studio 2005.
Параграф 2. Источник данных
В качестве источника данных будем использовать таблицы базы данных. База данных может быть любой, но для простоты изложения выберем наиболее простую - Microsoft Access. Например, создадим простую базу с именем Animals. Последовательность создания базы, для тех, кто по какой либо причине это еще не делал, показана на рисунках 1-5. Действия выполняются после запуска Microsoft Access:
Рис.1. Создание БД
Создание таблицы БД:
Рис.2. Создание таблицы БД
Задание полей таблицы:
Рис.3. Задание полей таблицы
После задания полей таблицы и попытки закрыть окно Table, среда запросит имя файла базы данных. Запишем любое имя, например ThisAnimals.
Рис.4. Открытие созданной таблицы базы данных
Кликнем правой кнопкой мышки по имени таблицы базы данных - ThisAnimals - и в открывшейся таблице введем информацию, например такую:
Рис.5. Заполнение таблицы информацией
Параграф 3. Создание проекта решения
Создадим простой Windows проект решения, как мы это делали неоднократно (Меню File/New/Project). Дадим имя проекту RepView, как показано на Рис.6:
Рис.6. Создание проекта решения
Поместим на форму два контрола Button и ReportViewer, как показано на Рис.7:
Рис.7. Добавление рабочих контролов
Проект создан, но прежде чем заполнять его кодом, отвлечемся на источник информации.
Параграф 4. Источник данных для отображения
Нажимаем в правом верхнем углу контрола треугольничек и выбираем пункт Design a new Report (Рис.7.). В появившемся окне редактора ReportViewer, нажимаем кнопку "Add New Source.."(Рис.8.)
Рис.8. Добавление источника данных
Прежде чем выбрать DateBase и нажать кнопку Next (Рис.9.), мы можем скопировать файл созданной выше базы данных (файл Animals.mdb) в директорию проекта решения (хотя это и не является обязательным, среда предложит Вам позже выполнить это еще раз, но и там у Вас останется право выбора).
Рис.9. Добавление источника данных
Нажимаем кнопку New и далее выбираем DataSource и DataFileName, как показано на Рис.10.
Рис.10. Добавление DataSource и DataFileName
В результате выбора получим результат:
Рис.11. Результат выбора источника данных
После нажатия кнопки Next не соглашаемся включить файл базы данных в текущий проект (зависит от цели задачи).
Результат мы видим на Рис.12:
Рис.12. Результат выбора источника данных
Нажимаем кнопку Finish. Результат выбора источника данных будет иметь вид Рис.13:
Рис.13. Результат выбора источника данных
Параграф 5. Отображение данных
Кликнем мышкой в поле дизайнера Report1.rdlc и в меню View выберем ToolBox. В результате в проекте отобразится ToolBox, с контролами, которые доступны для использования в ReportViewer (Рис.14.). Здесь мы видим все доступные для отображения в ReportViever контролы. Вначале будем использовать таблицу. Перетащим таблицу на панель дизайнера:
Рис.14. Добавление таблицы в дизайнер ReportViever
Вновь вернемся на вкладку DtatSource и перетащим поля источника во вторую строку таблицы, как показано на Рис.15.
Рис.15. Добавление полей отображения в ReportViever
Мы можем перетащить поля и в третью строку. При этом, по умолчанию, ячейка таблицы будет восприниматься как сумма содержимого ячеек данного столбца:
=Sum(Fields!Numbers.Value)
Достаточно кликнуть правой кнопкой мышки по данной ячейке и выбрать пункт "fx Expression..." мы отобразим окно "Edit Expression", где можно подобрать любую другую функцию из множества доступных. Для нашего примера в первой ячейке третьей строки запишем просто слово "Итого".
Если мы выполним решение на данном этапе, то получим сообщение:
The sourse on the report difination has not been specified
Иначе, мы определили структуру отображения, но пока не дали сами данные для отображения. Однако, учитывая, что Visual Studiо сохраняет все при выполнении решения, мы, тем самым сохранили и файл Report1.rdlc, который на данный момент содержит структуру отображения данных и структуру ее источников в виде нашего AnimalsDataSet.
private void button1_Click(object sender, EventArgs e)
{
DataSet MyDataSet = new DataSet();
string connectionString = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=";
//Там где находится файл базы данных
string sBank = @"C:\Bases\Animals.mdb";
string sSql = "Select * from thisanimals";
using (OleDbConnection oleConn = new OleDbConnection(connectionString + sBank))
{
try
{
oleConn.Open();
OleDbCommand olecmd = new OleDbCommand(sSql, oleConn);
olecmd.CommandType = CommandType.Text;
OleDbDataAdapter da = new OleDbDataAdapter(olecmd);
da.Fill(MyDataSet);
}
catch (Exception/* ex*/)
{
return;
}
}
reportViewer1.ProcessingMode = ProcessingMode.Local;
reportViewer1.LocalReport.ReportEmbeddedResource = "RepView.Report1.rdlc";
this.reportViewer1.LocalReport.DataSources.Add(new ReportDataSource(
"AnimalsDataSet_ThisAnimals", MyDataSet.Tables[0]));
this.reportViewer1.RefreshReport();
}
Следует особо обратить внимание на то, как заданы ReportEmbeddedResource (RepView.Report1.rdlc) и DataSources - ("AnimalsDataSet_ThisAnimals", MyDataSet.Tables[0]). Нарушение пунктуации приведет к ошибке. Выполним решение и увидим результат (Рис.16.):
Рис.16. Использование ReportViever для отображения табличных данных
Теперь добавим контрол Chart со вкладки Tools ReportViewer. И, как показано на Рис.17. перетащим поля в своеобразные ушки контрола, которые появляются при двойном клике мышкой в поле контрола.
Рис.17. Использование ReportViever для отображения табличных данных
Кликнем правой кнопкой мышки на контроле Chart и выберем пункт Properties - увидим панель, позволяющую выбрать практически все стандартные диаграммы Microsoft (Word, Excel) и задать множество свойств. Выберем понравившуюся нам диаграмму (Рис.18.).
Рис.18. Выбор диаграммы
После нажатия кнопки OK, выполним решение. Результат показан на Рис.19:
Рис.19. Выбор диаграммы
Параграф 6. Упрощенный способ отображения данных
Владимир Розанов (инженер-программист, Полесский государственный университет) прислал письмо:
Спасибо за статью. Дополнение. Загрузка информации из базы данных ReportViewer может производить без включения программных кодов, как вы предлагаете (через свойства).
Спасибо Владимиру, именно благодаря ему, мне пришлось продолжить статью. Я вполне согласен с Владимиром, достаточно установить свойства, как показано на Рис.20., и написать код, приведенный ниже, и при загрузке решения на выполнение мы получим тот же результат, что и на Рис.19. Этого во многих случаях, вполне достаточно для выполнения цели создания приложения.
private void Form1_Load(object sender, EventArgs e)
{
this.ThisAnimalsTableAdapter.Fill(this.AnimalsDataSet.ThisAnimals);
this.reportViewer1.RefreshReport();
}
Рис.20. Упрощенный способ отображения данных
Однако, мы, при этом, теряем гибкость отображения. Для каждого использования ReportViewer потребуется создать свой файл ReportEmbeddedResource (RepView.Report1.rdlc, RepView.Report2.rdlc....). Приведенный же метод позволяет использовать многократно один и тот же файл ReportEmbeddedResource. Простейший пример приводится ниже.
Параграф 7. Использование одного ReportEmbeddedResource для вывода различных отчетов
Создадим еще одну таблицу в нашей базе данных (связанную по id с ранее созданной), как показано на Рис.21.,:
Рис.21. Создание дополнительной таблицы
Добавим еще одну кнопку и контрол Label на форму, и будем использовать следующий код (приводится полностью):
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
using System.Data.OleDb;
using Microsoft.Reporting.WinForms;
namespace RepView
{
public partial class Form1 : Form
{
string sSql = string.Empty;
public Form1()
{
InitializeComponent();
}
private void Form1_Load(object sender, EventArgs e)
{
label1.Text = "";
this.ThisAnimalsTableAdapter.Fill(this.AnimalsDataSet.ThisAnimals);
this.reportViewer1.RefreshReport();
}
private void button1_Click(object sender, EventArgs e)
{
sSql = "Select * from thisanimals order by id";
label1.Text = "Число зверей в зверинце:";
vLoadData();
}
private void button2_Click(object sender, EventArgs e)
{
label1.Text = "Число сотрудников ухаживающих за животными";
sSql = "Select ta.id as id,ta.name as name,ws.numbers as numbers from thisanimals ta ";
sSql +="left join workers ws on ws.id=ta.id order by ta.id";
vLoadData();
}
private void vLoadData()
{
reportViewer1.LocalReport.DataSources.Clear();
DataSet MyDataSet = new DataSet();
string connectionString = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=";
string sBank = @"C:\Bases\Animals.mdb";
using (OleDbConnection oleConn = new OleDbConnection(connectionString + sBank))
{
try
{
oleConn.Open();
OleDbCommand olecmd = new OleDbCommand(sSql, oleConn);
olecmd.CommandType = CommandType.Text;
OleDbDataAdapter da = new OleDbDataAdapter(olecmd);
da.Fill(MyDataSet);
}
catch (Exception/* ex*/)
{
return;
}
}
reportViewer1.ProcessingMode = ProcessingMode.Local;
reportViewer1.LocalReport.ReportEmbeddedResource = "RepView.Report1.rdlc";
this.reportViewer1.LocalReport.DataSources.Add(
new ReportDataSource("AnimalsDataSet_ThisAnimals", MyDataSet.Tables[0]));
this.reportViewer1.RefreshReport();
}
}
}
Цветом выделено предложение Select. Второе из них приводит названия выбираемых полей из двух таблиц к их названиям в созданном нами "AnimalsDataSet.ThisAnimals". Это приведение и позволяет использовать файл "ReportEmbeddedResource" уже созданный нами для отображения новых данных.
Результат выполнения приложения при поочередном нажатии кнопок 1 и 2 показан на Рис.22:
Рис.22. Использование одного ReportEmbeddedResource для вывода различных отчетов
Скачать код примеров
Распаковав скачанный файл вы найдете одну директорию, с решением, содержащим код последнего примера и файл Animals.mdb. Директорию с решением можно поместить в любое место любого жесткого диска, для последующего его открытия в Visual Studio 2005 и выше. Файл базы данных Animals.mdb должен быть помещен в директорию C:\Bases\, которую Вам придется создать. После этого Вы можете продолжить эксперименты с кодом.
Скачать коды примеров ~112 кб.
Молчанов Владислав 25.11.2008г.
Еcли Вы пришли с поискового сервера - посетите мою главную страничку
На главной странице Ва узнаете, как я могу помочь Вам в написании офисной программы любой сложности в соответствии с Вашими запросами. И найдете ряд програм или ссылок на образцы.
Кроме того - на главной странице Вы найдете бесплатные программы: программы комплекса Veles - программы для автолюбителей, программы из раздела графика - программы для работы с фото, сделанными цифровым фотоаппаратом, программу Bricks - игрушку для детей и взрослых, программу записную книжку, программу TellMe - говорящий Русско-Английский разговорник - программу для тех, кто собирается погостить за бугром или повысить свои знания в английском, теоретический материал по программированию в среде Borland C++ Builder, C# (Windows приложения и ASP.Net Web сайты).