FluentReport.Rdlc 1.0.0

FluentReport

Librería .NET 10 para generar PDFs y Excel usando una API fluent en C#. Usa SkiaSharp como motor de renderizado PDF y ClosedXML para Excel. Funciona en Linux sin dependencias nativas adicionales.

Características

• API fluent para construir documentos PDF y Excel (.xlsx)
• Motor de layout con cálculo de tamaños (measure/arrange)
• Elementos: texto, columnas, filas, tablas, imágenes, espaciadores, líneas, bordes, padding, salto de página
• Soporte de cabecera y pie de página
• Numeración de páginas dinámica
• Salto de página automático cuando el contenido supera la página
• Renderer Excel (FluentReport.Excel): genera .xlsx directamente desde el mismo fluent API
• Importador RDLC (FluentReport.Rdlc): convierte archivos .rdlc (SSRS) en documentos PDF/Excel
• Compatible con Linux (SkiaSharp.NativeAssets.Linux.NoDependencies)

Instalación

Instala el paquete principal desde NuGet (FluentReport):

dotnet add package FluentReport

Para generar Excel, instala además el renderer (FluentReport.Excel):

dotnet add package FluentReport.Excel

Para importar reportes .rdlc existentes (FluentReport.Rdlc):

dotnet add package FluentReport.Rdlc

Uso rápido

using FluentReport;
using FluentReport.Core;

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.MarginAll(40);

        page.Header()
            .Text("Mi Reporte")
            .FontSize(20)
            .Bold()
            .AlignCenter();

        page.Content().Column(col =>
        {
            col.Spacing(8);

            col.Item().Text("Introducción").FontSize(14).Bold();
            col.Item().Text("Este es el contenido del reporte.");
            col.Item().Line(1);

            col.Item().Table(table =>
            {
                table.ColumnsDefinition(cols =>
                {
                    cols.RelativeColumn(1);
                    cols.RelativeColumn(2);
                    cols.ConstantColumn(80);
                });

                table.Header(h =>
                {
                    h.Cell().Background("#CCCCCC").Padding(5).Text("Nombre").Bold();
                    h.Cell().Background("#CCCCCC").Padding(5).Text("Descripción").Bold();
                    h.Cell().Background("#CCCCCC").Padding(5).Text("Valor").Bold();
                });

                table.Cell().Padding(5).Text("Producto A");
                table.Cell().Padding(5).Text("Descripción del producto A");
                table.Cell().Padding(5).Text("$100");

                table.Cell().Padding(5).Text("Producto B");
                table.Cell().Padding(5).Text("Descripción del producto B");
                table.Cell().Padding(5).Text("$200");
            });
        });

        page.Footer().AlignCenter().Text(x =>
        {
            x.Span("Página ");
            x.CurrentPageNumber();
            x.Span(" de ");
            x.TotalPages();
        });
    });
})
.GeneratePdf("reporte.pdf");

Excel – Uso rápido

Agrega using FluentReport.Excel; y usa el mismo fluent API con GenerateExcel:

using FluentReport;
using FluentReport.Core;
using FluentReport.Excel;

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.MarginAll(40);

        page.Header()
            .Text("Mi Reporte Excel")
            .FontSize(20)
            .Bold()
            .AlignCenter();

        page.Content().Column(col =>
        {
            col.Spacing(8);

            col.Item().Text("Resumen de Ventas").FontSize(14).Bold();

            col.Item().Table(table =>
            {
                table.ColumnsDefinition(cols =>
                {
                    cols.RelativeColumn(2);
                    cols.RelativeColumn(1);
                    cols.RelativeColumn(1);
                });

                table.Header(h =>
                {
                    h.Cell().Background("#4472C4").Padding(4).Text("Región").Bold().Color("#FFFFFF");
                    h.Cell().Background("#4472C4").Padding(4).Text("Unidades").Bold().Color("#FFFFFF");
                    h.Cell().Background("#4472C4").Padding(4).Text("Ingresos").Bold().Color("#FFFFFF");
                });
                table.BorderEachCell(1);

                table.Cell().Padding(4).Text("Norte");
                table.Cell().Padding(4).Text("1 200");
                table.Cell().Padding(4).Text("$48 000");
            });
        });
    });
})
.GenerateExcel("reporte.xlsx");

Comportamiento del renderer Excel

RDLC – Importar reportes existentes

FluentReport.Rdlc permite convertir archivos .rdlc (Visual Studio / SSRS) en documentos FluentReport listos para renderizar como PDF o Excel.

using FluentReport.Rdlc;

var doc = DocumentRdlcExtensions.FromRdlc(
    "reportes/catalogo.rdlc",
    datasets: new Dictionary<string, IEnumerable<object>>
    {
        ["Productos"] = productos.Cast<object>()
    },
    parameters: new Dictionary<string, object>
    {
        ["Empresa"] = "Acme Corp."
    });

doc.GeneratePdf("catalogo.pdf");

Elementos RDLC soportados: Textbox, Line, Image, Tablix (con datos y ColSpan), PageHeader, PageFooter, márgenes y tamaño de página.

Expresiones soportadas: =Fields!X.Value, =Parameters!X.Value y literales.

📄 Documentación completa, limitaciones y ejemplos: docs/rdlc-import.md

Nuevos elementos (API fluent)

Lista de datos — List<T>()

Repite una plantilla por cada elemento de una colección:

page.Content().List(pedidos, (container, pedido) =>
{
    container.Column(col =>
    {
        col.Item().Text(pedido.Descripcion).Bold();
        col.Item().Text($"Total: {pedido.Total:C}");
    });
}, spacing: 8f);

Gráficos — Chart()

Genera gráficos de barras o líneas con ejes, leyenda y múltiples series:

page.Content().Chart()
    .Type(ChartType.Bar)
    .Title("Ventas por Trimestre")
    .Categories(new[] { "Q1", "Q2", "Q3", "Q4" })
    .AddSeries("Ingresos", new double[] { 100_000, 145_000, 132_000, 198_000 })
    .AddSeries("Costos",   new double[] { 78_000, 91_000, 85_000, 110_000 }, "#FF6666")
    .Height(220);

Documento anidado — Subreport()

Incrusta un Document completo dentro de otro:

var anexo = Document.Create(c => { /* ... */ });
page.Content().Subreport(anexo);

ColSpan en tablas

Las celdas de encabezado y de datos pueden abarcar múltiples columnas:

table.Header(h =>
{
    h.Cell(3).Background("#4472C4").Text("Encabezado extendido").Color("#FFFFFF");
});

Estilos condicionales en texto

BoldResolver, ItalicResolver y ColorResolver permiten evaluar el estilo en tiempo de render:

t.Span(item.Estado, s =>
{
    s.ColorResolver = () => item.Activo
        ? new ReportColor(0, 150, 0)
        : new ReportColor(200, 0, 0);
});

API Reference

Document

PageBuilder

ContainerBuilder

TextBuilder

ColumnBuilder

RowBuilder

TableBuilder

TableColumnDefinitionBuilder

DynamicTextBuilder (para pie de página)

Tamaños de página predefinidos

Estructura del proyecto

src/
├── FluentReport/               # Librería principal (PDF)
│   ├── Document.cs             # Punto de entrada
│   ├── Core/                   # Tipos base (Size, Position, Rect, PageSize...)
│   ├── Styling/                # Estilos (TextStyle, BorderStyle, Color)
│   ├── Elements/               # Elementos renderizables
│   ├── Builders/               # Fluent API builders
│   └── Rendering/              # Motor de renderizado con SkiaSharp
├── FluentReport.Excel/         # Renderer Excel (opcional)
│   ├── ExcelDocumentRenderer.cs # Motor de renderizado Excel con ClosedXML
│   └── DocumentExcelExtensions.cs # Métodos de extensión GenerateExcel
└── FluentReport.Rdlc/          # Importador RDLC (opcional)
    ├── RdlcDocumentFactory.cs  # Parser XML .rdlc → DocumentSettings
    ├── RdlcExpressionEvaluator.cs # Evaluador de expresiones =Fields!/=Parameters!
    └── DocumentRdlcExtensions.cs # Métodos de extensión FromRdlc
tests/
├── FluentReport.Tests/         # Tests PDF con xUnit
├── FluentReport.Excel.Tests/   # Tests Excel con xUnit
└── FluentReport.Rdlc.Tests/    # Tests RDLC con xUnit
docs/
└── rdlc-import.md              # Guía completa del importador RDLC
samples/
└── FluentReport.Samples/       # Samples PDF (01-06) y Excel (07-09)

Dependencias

• SkiaSharp 3.116.1 — renderizado PDF
• SkiaSharp.NativeAssets.Linux.NoDependencies — soporte Linux sin libfontconfig
• ClosedXML 0.102.2 — renderizado Excel (solo FluentReport.Excel)
• System.Xml.Linq (BCL) — parser RDLC (solo FluentReport.Rdlc, sin dependencias adicionales)