ReportKit 8.6.4

ReportKit

Fluent-построитель PDF-отчетов на основе QuestPDF. Поддержка таблиц, группировки, сводок, альбомной ориентации и нумерации страниц.

Установка

dotnet add package ReportKit

API-справочник (класс Report)

Create(string title)

Создает новый отчет с указанным заголовком. Возвращает экземпляр Report для цепочки вызовов (fluent API).

var report = Report.Create("Отчет по сотрудникам");

Landscape()

Устанавливает альбомную ориентацию страницы. По умолчанию используется портретная ориентация A4.

var report = Report.Create("Широкий отчет").Landscape();

AddText(string text)

Добавляет текстовый абзац в отчет.

report.AddText("Данные за первый квартал 2024 года.");

AddTable(DataTable dataTable)

Добавляет форматированную таблицу с синими заголовками и чередующимися строками.

report.AddTable(dataTable);

AddGroupedTable(DataTable dataTable, string groupByColumn)

Добавляет таблицу с группировкой по указанному столбцу. Строки группируются по значениям столбца groupByColumn, после каждой группы выводится строка с промежуточными итогами по числовым столбцам.

report.AddGroupedTable(dataTable, "Отдел");

AddSummary(string columnName)

Добавляет блок сводки по указанному числовому столбцу последней добавленной таблицы. Выводит: Итого, Среднее, Мин, Макс.

report.AddSummary("Зарплата");

SavePdf(string path)

Сохраняет отчет в файл PDF по указанному пути.

report.SavePdf("report.pdf");

ToPdfBytes()

Возвращает отчет в виде массива байтов PDF.

byte[] pdf = report.ToPdfBytes();
File.WriteAllBytes("report.pdf", pdf);

Особенности

• Fluent API для удобного построения отчетов цепочкой вызовов.
• Автоматическая нумерация страниц в нижнем колонтитуле (формат: "Страница X из Y").
• Таблицы с синими заголовками и чередованием цвета строк.
• Группировка с автоматическим подсчетом промежуточных итогов.

Примеры использования

Простой отчет с таблицей и сводкой

using ReportKit;
using System.Data;

var dt = new DataTable();
dt.Columns.Add("Имя");
dt.Columns.Add("Зарплата", typeof(decimal));
dt.Rows.Add("Иванов", 50000);
dt.Rows.Add("Петров", 60000);

Report.Create("Зарплатная ведомость")
    .AddText("Отчет за апрель 2024 года")
    .AddTable(dt)
    .AddSummary("Зарплата")
    .SavePdf("salary_report.pdf");

Отчет с группировкой в альбомной ориентации

var dt = new DataTable();
dt.Columns.Add("Отдел");
dt.Columns.Add("Сотрудник");
dt.Columns.Add("Зарплата", typeof(decimal));
dt.Rows.Add("IT", "Иванов", 80000);
dt.Rows.Add("IT", "Петров", 75000);
dt.Rows.Add("HR", "Сидорова", 60000);

Report.Create("Отчет по отделам")
    .Landscape()
    .AddText("Группировка сотрудников по отделам")
    .AddGroupedTable(dt, "Отдел")
    .AddSummary("Зарплата")
    .SavePdf("departments_report.pdf");