La Biblioteca PDF de C#

HTML a PDF

Online Demo Ver Todos los Ejemplos de Código %s

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

PM >Install-Package IronPdf

Install-Package IronPdf

VIDEOS

Cómo usar logging personalizado en C#

Curtis Chau

Updated: 19 de julio de 2026

Migrar de fo .NET (FO .NET) a IronPDF es una actualización importante para su proceso de generación de PDF .NET . Esta guía ofrece una ruta sencilla, paso a paso, para realizar la transición de su código base desde el obsoleto marcado XSL-FO a la generación moderna de PDF basada en HTML/CSS, utilizando las habilidades que su equipo de desarrollo ya tiene.

Para equipos en España, la migración desde fo.NET adquiere una urgencia adicional por razones regulatorias. El Real Decreto-Ley 15/2025 (VeriFactu) exige que el software de facturación genere PDF con la leyenda VERI*FACTU e incluya la cadena de huella encadenada para que las facturas sean verificables en la sede electrónica de la AEAT. fo.NET, al basarse en el marcado XSL-FO, no tiene capacidad de firma digital ni de generación de metadatos estructurados requeridos por VeriFactu. Las penalizaciones por incumplimiento pueden alcanzar los 150.000 € anuales. TicketBAI —obligatorio en Bizkaia, Gipuzkoa y Araba— requiere además firma XAdES y adjuntos PDF firmados con PAdES conforme a eIDAS. La Ley Crea y Crece impone la generación de Facturae XML incrustado en PDF/A-3 para la factura electrónica B2B a través de FACe. IronPDF cubre todos estos requisitos de forma nativa, además de garantizar el procesamiento on-premise que facilita el cumplimiento con la LOPDGDD y la supervisión de la AEPD.

Por qué migrar de fo.net a IronPDF

Los retos de fo.net

fo .NET es un renderizador de XSL-FO a PDF con varias limitaciones para el desarrollo actual:

Tecnología obsoleta: XSL-FO (Extensible Stylesheet Language Formatting Objects) es una especificación del W3C de 2001, sin actualizaciones desde 2006, y se considera en gran medida obsoleta.
Curva de aprendizaje compleja: XSL-FO requiere aprender un marcado complejo basado en XML con objetos de formato especializados (fo:block, fo:table, fo:page-sequence, etc.).
No hay compatibilidad con HTML/CSS: fo .NET no puede representar HTML ni CSS; requiere una conversión manual de HTML a marcado XSL-FO.
Sin mantenimiento: el repositorio original de CodePlex está descontinuado; Las bifurcaciones de GitHub ya no se mantienen de forma activa.
Solo para Windows: fo .NET tiene dependencias internas en System.Drawing que le impiden funcionar en Linux/macOS.
Funciones modernas limitadas: no hay compatibilidad con JavaScript, CSS3, flexbox/grid ni fuentes web modernas.
Sin representación de URL: fo .NET no puede representar páginas web directamente; requiere conversión manual de HTML a XSL-FO.

Comparación entre fo.net e IronPDF

Aspecto	fo.net (FO.NET)	IronPDF
Formato de entrada	XSL-FO (XML obsoleto)	HTML/CSS (estándares web modernos)
Curva de aprendizaje	Steep (conocimientos de XSL-FO)	Suave (conocimientos de HTML/CSS)
Mantenimiento	Sin mantenimiento	Mantenimiento activo mensual
Soporte de plataformas	Sólo para Windows	Verdadera multiplataforma (.NET 6/7/8/9/10+)
Soporte CSS	Ninguno	CSS3 completo (Flexbox, Grid)
JavaScript	Ninguno	Compatibilidad total con JavaScript
Representación de URL	No soportado	Incorporado en
Características modernas	Limitado	Encabezados, pies de página, marcas de agua, seguridad
Documentación	Desactualizado	Tutoriales completos

Por qué tiene sentido el cambio

fo.net se diseñó cuando se esperaba que XSL-FO se convirtiera en un estándar para el formato de documentos. Esa expectativa nunca se materializó. HTML/CSS se ha convertido en el formato de documento universal: más del 98% de los desarrolladores conocen HTML/CSS, frente a menos del 1% que conocen XSL-FO. La mayoría de los recursos XSL-FO datan de 2005-2010, lo que dificulta cada vez más su mantenimiento.

IronPDF le permite utilizar los conocimientos que ya posee para crear PDF profesionales, con compatibilidad total con las versiones modernas de .NET, incluidas .NET 10 y C# 14, a medida que estén disponibles hasta 2025 y 2026.

Antes de empezar

Prerrequisitos

**Entorno .NET :**IronPDF es compatible con .NET Framework 4.6.2+, .NET Core 3.1+, .NET 5/6/7/8/9+
Acceso a NuGet : asegúrese de poder instalar paquetes desde NuGet
Clave de licencia: Obtenga su clave de licencia de IronPDF para uso en producción en IronPDF

Haga una copia de seguridad de su proyecto

# Create a backup branch
git checkout -b pre-ironpdf-migration
git add .
git commit -m "Backup before fo.net to IronPDF migration"

# Create a backup branch
git checkout -b pre-ironpdf-migration
git add .
git commit -m "Backup before fo.net to IronPDF migration"

SHELL

Identificar todo el uso de fo.net

# Find all fo.net references
grep -r "FonetDriver\|Fonet\|\.fo\"\|xsl-region" --include="*.cs" --include="*.csproj" .

# Find all XSL-FO template files
find . -name "*.fo" -o -name "*.xslfo" -o -name "*xsl-fo*"

# Find all fo.net references
grep -r "FonetDriver\|Fonet\|\.fo\"\|xsl-region" --include="*.cs" --include="*.csproj" .

# Find all XSL-FO template files
find . -name "*.fo" -o -name "*.xslfo" -o -name "*xsl-fo*"

SHELL

Documente sus plantillas XSL-FO

Antes de la migración, catalogue todos los archivos XSL-FO y anótelos:

Dimensiones y márgenes de la página
Fuentes utilizadas
Tablas y sus estructuras
Encabezados y pies de página (fo:static-content)
Patrones de numeración de páginas
Carga de fuentes

Inicio rápido de la migración

Paso 1: Actualizar paquetes NuGet

# Remove fo.net package
dotnet remove package Fonet
dotnet remove package FO.NET

# Install IronPDF
dotnet add package IronPdf

# Remove fo.net package
dotnet remove package Fonet
dotnet remove package FO.NET

# Install IronPDF
dotnet add package IronPdf

SHELL

Paso 2: Actualizar los espacios de nombres

// Before (fo.net)
using Fonet;
using Fonet.Render.Pdf;
using System.Xml;

// After (IronPDF)
using IronPdf;
using IronPdf.Rendering;

// Before (fo.net)
using Fonet;
using Fonet.Render.Pdf;
using System.Xml;

// After (IronPDF)
using IronPdf;
using IronPdf.Rendering;

Imports IronPdf
Imports IronPdf.Rendering

Imports IronPdf
Imports IronPdf.Rendering

Paso 3: Inicializar IronPDF

// Set license key at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Set license key at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

' Set license key at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

' Set license key at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

Paso 4: Patrón básico de conversión

// Before (fo.net with XSL-FO)
FonetDriver driver = FonetDriver.Make();
using (FileStream output = new FileStream("output.pdf", FileMode.Create))
{
    driver.Render(new StringReader(xslFoContent), output);
}

// After (IronPDF with HTML)
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("output.pdf");

// Before (fo.net with XSL-FO)
FonetDriver driver = FonetDriver.Make();
using (FileStream output = new FileStream("output.pdf", FileMode.Create))
{
    driver.Render(new StringReader(xslFoContent), output);
}

// After (IronPDF with HTML)
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("output.pdf");

Imports System.IO
Imports Fonet
Imports IronPdf

' Before (fo.net with XSL-FO)
Dim driver As FonetDriver = FonetDriver.Make()
Using output As FileStream = New FileStream("output.pdf", FileMode.Create)
    driver.Render(New StringReader(xslFoContent), output)
End Using

' After (IronPDF with HTML)
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("output.pdf")

Imports System.IO
Imports Fonet
Imports IronPdf

' Before (fo.net with XSL-FO)
Dim driver As FonetDriver = FonetDriver.Make()
Using output As FileStream = New FileStream("output.pdf", FileMode.Create)
    driver.Render(New StringReader(xslFoContent), output)
End Using

' After (IronPDF with HTML)
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("output.pdf")

Referencia completa de la API

Mapeo de espacios de nombres

espacio de nombres fo.net	Equivalente de IronPDF
`Fonet`	`IronPdf`
`Fonet.Render.Pdf`	`IronPdf`
`Fonet.Layout`	N/A
`Fonet.Fo`	N/A
`Fonet.Image`	`IronPdf`

FonetDriver a ChromePdfRenderer

Método FonetDriver	Equivalente de IronPDF
`FonetDriver.Make()`	`new ChromePdfRenderer()`
`driver.Render(inputStream, outputStream)`	`renderer.RenderHtmlAsPdf(html)`
`driver.Render(inputFile, outputStream)`	`renderer.RenderHtmlFileAsPdf(path)`
`driver.BaseDirectory`	`RenderingOptions.BaseUrl`
`driver.OnError += handler`	Try/catch alrededor de render

Opciones de renderizado (configuración de PDF)

fo.net (Atributos XSL-FO)	Opciones de renderizado de IronPDF
`page-height`	`PaperSize` o `SetCustomPaperSize()`
`page-width`	`PaperSize`
`margin-top`	`MarginTop`
`margin-bottom`	`MarginBottom`
`margin-left`	`MarginLeft`
`margin-right`	`MarginRight`
`reference-orientation`	`PaperOrientation`

Guía de conversión de XSL-FO a HTML

Elementos XSL-FO a HTML/CSS

El cambio fundamental en esta migración a fo.net es la conversión de elementos XSL-FO a sus equivalentes HTML:

Elemento XSL-FO	Equivalente HTML/CSS
`<fo:root>`	`<html>`
`<fo:layout-master-set>`	Regla CSS `@page`
`<fo:simple-page-master>`	CSS `@page`
`<fo:page-sequence>`	`<body>` o `<div>`
`<fo:flow>`	`<main>` o `<div>`
`<fo:static-content>`	`HtmlHeaderFooter`
`<fo:block>`	`<p>`, `<div>`, `<h1>`-`<h6>`
`<fo:inline>`	`<span>`
`<fo:table>`	`<table>`
`<fo:table-row>`	`<tr>`
`<fo:table-cell>`	`<td>`, `<th>`
`<fo:list-block>`	`<ul>`, `<ol>`
`<fo:list-item>`	`<li>`
`<fo:external-graphic>`	`<img>`
`<fo:page-number>`	`{page}` marcador de posición
`<fo:page-number-citation>`	`{total-pages}`
`<fo:basic-link>`	`<a href>`

Propiedades XSL-FO a CSS

Propiedad XSL-FO	Equivalente en CSS	Ejemplo
`font-family`	`font-family`	Misma sintaxis
`font-size`	`font-size`	Misma sintaxis
`font-weight`	`font-weight`	`bold`, `normal`, `700`
`text-align`	`text-align`	`left`, `center`, `right`, `justify`
`color`	`color`	Hex, RGB, nombres
`background-color`	`background-color`	Misma sintaxis
`space-before`	`margin-top`	Antes del elemento
`space-after`	`margin-bottom`	Después del elemento
`start-indent`	`margin-left`	Sangría izquierda
`keep-together`	`page-break-inside: avoid`	Evitar interrupciones
`break-before="page"`	`page-break-before: always`	Forzar salto de página

Ejemplos de código

Ejemplo 0: Factura VeriFactu con datos españoles (NIF/CIF, AEAT)

Este ejemplo práctico muestra la diferencia fundamental entre fo.NET e IronPDF para generar una factura conforme con VeriFactu en España, con datos del NIF/CIF del emisor y receptor, importes en formato español (1.234,56 €) y la leyenda VERI*FACTU exigida por el Real Decreto 1007/2023:

Antes (fo.NET — no viable para VeriFactu):

// fo.NET requiere XSL-FO markup; no puede añadir leyenda VERI*FACTU
// ni gestionar la cadena de huellas encadenadas exigida por la AEAT
// XSL-FO tampoco soporta firma PAdES para TicketBAI

// fo.NET requiere XSL-FO markup; no puede añadir leyenda VERI*FACTU
// ni gestionar la cadena de huellas encadenadas exigida por la AEAT
// XSL-FO tampoco soporta firma PAdES para TicketBAI

' fo.NET requiere XSL-FO markup; no puede añadir leyenda VERI*FACTU
' ni gestionar la cadena de huellas encadenadas exigida por la AEAT
' XSL-FO tampoco soporta firma PAdES para TicketBAI

' fo.NET requiere XSL-FO markup; no puede añadir leyenda VERI*FACTU
' ni gestionar la cadena de huellas encadenadas exigida por la AEAT
' XSL-FO tampoco soporta firma PAdES para TicketBAI

Después (IronPDF — conforme a VeriFactu y TicketBAI):

// NuGet: Install-Package IronPdf
using IronPdf;
using System.Globalization;

class FacturaVeriFactu
{
    public static void GenerarFactura()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
        
        var culture = new CultureInfo("es-ES");
        var baseImponible = 2500.00m;
        var iva = baseImponible * 0.21m;
        var total = baseImponible + iva;
        
        var html = $@"
            <!DOCTYPE html><html lang='es'><body style='font-family:Arial; font-size:11pt;'>
                <h2>FACTURA — NIF Emisor: A12345678 | CIF Receptor: B98765432</h2>
                <p>Fecha: 28/05/2026 | Número: 2026-F-00456 | Período: 2T 2026</p>
                <table border='1' cellpadding='5' style='width:100%;border-collapse:collapse;'>
                    <tr><th>Concepto</th><th>Base (€)</th><th>IVA 21%</th><th>Total (€)</th></tr>
                    <tr><td>Desarrollo software AEAT</td>
                        <td>{baseImponible.ToString("N2", culture)} €</td>
                        <td>{iva.ToString("N2", culture)} €</td>
                        <td>{total.ToString("N2", culture)} €</td></tr>
                </table>
                <p style='font-size:9pt; border-top:1px solid #000; margin-top:20px;'>
                    *** VERI*FACTU *** | Verificable en https://www2.agenciatributaria.gob.es
                    | SII: Remitido | FNMT-RCM: Firmado digitalmente
                </p>
            </body></html>";
        
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("factura_verifactu_2026.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System.Globalization;

class FacturaVeriFactu
{
    public static void GenerarFactura()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
        
        var culture = new CultureInfo("es-ES");
        var baseImponible = 2500.00m;
        var iva = baseImponible * 0.21m;
        var total = baseImponible + iva;
        
        var html = $@"
            <!DOCTYPE html><html lang='es'><body style='font-family:Arial; font-size:11pt;'>
                <h2>FACTURA — NIF Emisor: A12345678 | CIF Receptor: B98765432</h2>
                <p>Fecha: 28/05/2026 | Número: 2026-F-00456 | Período: 2T 2026</p>
                <table border='1' cellpadding='5' style='width:100%;border-collapse:collapse;'>
                    <tr><th>Concepto</th><th>Base (€)</th><th>IVA 21%</th><th>Total (€)</th></tr>
                    <tr><td>Desarrollo software AEAT</td>
                        <td>{baseImponible.ToString("N2", culture)} €</td>
                        <td>{iva.ToString("N2", culture)} €</td>
                        <td>{total.ToString("N2", culture)} €</td></tr>
                </table>
                <p style='font-size:9pt; border-top:1px solid #000; margin-top:20px;'>
                    *** VERI*FACTU *** | Verificable en https://www2.agenciatributaria.gob.es
                    | SII: Remitido | FNMT-RCM: Firmado digitalmente
                </p>
            </body></html>";
        
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("factura_verifactu_2026.pdf");
    }
}

IronPDF genera el PDF con la leyenda VERI*FACTU, los datos del NIF/CIF del emisor, los importes en formato español con separador decimal de coma y la referencia a la sede de la AEAT. fo.NET no puede producir este resultado debido a sus limitaciones técnicas con el marcado XSL-FO.

Ejemplo 1: HTML básico a PDF

Antes (fo.net con XSL-FO):

// NuGet: Install-Package Fonet
using Fonet;
using Fonet.Render.Pdf;
using System.IO;
using System.Xml;

class Program
{
    static void Main()
    {
        // fo.net requires XSL-FO format, not HTML
        // First convert HTML to XSL-FO (manual process)
        string xslFo = @"<?xml version='1.0' encoding='utf-8'?>
            <fo:root xmlns:fo='http://www.w3.org/1999/XSL/Format'>
                <fo:layout-master-set>
                    <fo:simple-page-master master-name='page'>
                        <fo:region-body/>
                    </fo:simple-page-master>
                </fo:layout-master-set>
                <fo:page-sequence master-reference='page'>
                    <fo:flow flow-name='xsl-region-body'>
                        <fo:block>Hello World</fo:block>
                    </fo:flow>
                </fo:page-sequence>
            </fo:root>";
        
        FonetDriver driver = FonetDriver.Make();
        driver.Render(new StringReader(xslFo), 
            new FileStream("output.pdf", FileMode.Create));
    }
}

// NuGet: Install-Package Fonet
using Fonet;
using Fonet.Render.Pdf;
using System.IO;
using System.Xml;

class Program
{
    static void Main()
    {
        // fo.net requires XSL-FO format, not HTML
        // First convert HTML to XSL-FO (manual process)
        string xslFo = @"<?xml version='1.0' encoding='utf-8'?>
            <fo:root xmlns:fo='http://www.w3.org/1999/XSL/Format'>
                <fo:layout-master-set>
                    <fo:simple-page-master master-name='page'>
                        <fo:region-body/>
                    </fo:simple-page-master>
                </fo:layout-master-set>
                <fo:page-sequence master-reference='page'>
                    <fo:flow flow-name='xsl-region-body'>
                        <fo:block>Hello World</fo:block>
                    </fo:flow>
                </fo:page-sequence>
            </fo:root>";
        
        FonetDriver driver = FonetDriver.Make();
        driver.Render(new StringReader(xslFo), 
            new FileStream("output.pdf", FileMode.Create));
    }
}

' NuGet: Install-Package Fonet
Imports Fonet
Imports Fonet.Render.Pdf
Imports System.IO
Imports System.Xml

Class Program
    Shared Sub Main()
        ' fo.net requires XSL-FO format, not HTML
        ' First convert HTML to XSL-FO (manual process)
        Dim xslFo As String = "<?xml version='1.0' encoding='utf-8'?>" & _
            "<fo:root xmlns:fo='http://www.w3.org/1999/XSL/Format'>" & _
                "<fo:layout-master-set>" & _
                    "<fo:simple-page-master master-name='page'>" & _
                        "<fo:region-body/>" & _
                    "</fo:simple-page-master>" & _
                "</fo:layout-master-set>" & _
                "<fo:page-sequence master-reference='page'>" & _
                    "<fo:flow flow-name='xsl-region-body'>" & _
                        "<fo:block>Hello World</fo:block>" & _
                    "</fo:flow>" & _
                "</fo:page-sequence>" & _
            "</fo:root>"

        Dim driver As FonetDriver = FonetDriver.Make()
        driver.Render(New StringReader(xslFo), 
            New FileStream("output.pdf", FileMode.Create))
    End Sub
End Class

' NuGet: Install-Package Fonet
Imports Fonet
Imports Fonet.Render.Pdf
Imports System.IO
Imports System.Xml

Class Program
    Shared Sub Main()
        ' fo.net requires XSL-FO format, not HTML
        ' First convert HTML to XSL-FO (manual process)
        Dim xslFo As String = "<?xml version='1.0' encoding='utf-8'?>" & _
            "<fo:root xmlns:fo='http://www.w3.org/1999/XSL/Format'>" & _
                "<fo:layout-master-set>" & _
                    "<fo:simple-page-master master-name='page'>" & _
                        "<fo:region-body/>" & _
                    "</fo:simple-page-master>" & _
                "</fo:layout-master-set>" & _
                "<fo:page-sequence master-reference='page'>" & _
                    "<fo:flow flow-name='xsl-region-body'>" & _
                        "<fo:block>Hello World</fo:block>" & _
                    "</fo:flow>" & _
                "</fo:page-sequence>" & _
            "</fo:root>"

        Dim driver As FonetDriver = FonetDriver.Make()
        driver.Render(New StringReader(xslFo), 
            New FileStream("output.pdf", FileMode.Create))
    End Sub
End Class

Después (IronPDF con HTML):

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string html = "<h1>Hello World</h1><p>This is HTML content.</p>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string html = "<h1>Hello World</h1><p>This is HTML content.</p>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim html As String = "<h1>Hello World</h1><p>This is HTML content.</p>"
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("output.pdf")
    End Sub
End Class

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim html As String = "<h1>Hello World</h1><p>This is HTML content.</p>"
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("output.pdf")
    End Sub
End Class

El método IronPDF reduce más de 25 líneas de marcado XSL-FO a sólo 4 líneas de código C# limpio. Para obtener más opciones de HTML a PDF, consulte la documentación de HTML a PDF de IronPDF.

Ejemplo 2: PDF con ajustes personalizados

Antes (fo.net con XSL-FO):

// NuGet: Install-Package Fonet
using Fonet;
using Fonet.Render.Pdf;
using System.IO;

class Program
{
    static void Main()
    {
        // fo.net settings are configured in XSL-FO markup
        string xslFo = @"<?xml version='1.0' encoding='utf-8'?>
            <fo:root xmlns:fo='http://www.w3.org/1999/XSL/Format'>
                <fo:layout-master-set>
                    <fo:simple-page-master master-name='A4' 
                        page-height='297mm' page-width='210mm'
                        margin-top='20mm' margin-bottom='20mm'
                        margin-left='25mm' margin-right='25mm'>
                        <fo:region-body/>
                    </fo:simple-page-master>
                </fo:layout-master-set>
                <fo:page-sequence master-reference='A4'>
                    <fo:flow flow-name='xsl-region-body'>
                        <fo:block font-size='14pt'>Custom PDF</fo:block>
                    </fo:flow>
                </fo:page-sequence>
            </fo:root>";
        
        FonetDriver driver = FonetDriver.Make();
        driver.Render(new StringReader(xslFo), 
            new FileStream("custom.pdf", FileMode.Create));
    }
}

// NuGet: Install-Package Fonet
using Fonet;
using Fonet.Render.Pdf;
using System.IO;

class Program
{
    static void Main()
    {
        // fo.net settings are configured in XSL-FO markup
        string xslFo = @"<?xml version='1.0' encoding='utf-8'?>
            <fo:root xmlns:fo='http://www.w3.org/1999/XSL/Format'>
                <fo:layout-master-set>
                    <fo:simple-page-master master-name='A4' 
                        page-height='297mm' page-width='210mm'
                        margin-top='20mm' margin-bottom='20mm'
                        margin-left='25mm' margin-right='25mm'>
                        <fo:region-body/>
                    </fo:simple-page-master>
                </fo:layout-master-set>
                <fo:page-sequence master-reference='A4'>
                    <fo:flow flow-name='xsl-region-body'>
                        <fo:block font-size='14pt'>Custom PDF</fo:block>
                    </fo:flow>
                </fo:page-sequence>
            </fo:root>";
        
        FonetDriver driver = FonetDriver.Make();
        driver.Render(new StringReader(xslFo), 
            new FileStream("custom.pdf", FileMode.Create));
    }
}

' NuGet: Install-Package Fonet
Imports Fonet
Imports Fonet.Render.Pdf
Imports System.IO

Class Program
    Shared Sub Main()
        ' fo.net settings are configured in XSL-FO markup
        Dim xslFo As String = "<?xml version='1.0' encoding='utf-8'?>
            <fo:root xmlns:fo='http://www.w3.org/1999/XSL/Format'>
                <fo:layout-master-set>
                    <fo:simple-page-master master-name='A4' 
                        page-height='297mm' page-width='210mm'
                        margin-top='20mm' margin-bottom='20mm'
                        margin-left='25mm' margin-right='25mm'>
                        <fo:region-body/>
                    </fo:simple-page-master>
                </fo:layout-master-set>
                <fo:page-sequence master-reference='A4'>
                    <fo:flow flow-name='xsl-region-body'>
                        <fo:block font-size='14pt'>Custom PDF</fo:block>
                    </fo:flow>
                </fo:page-sequence>
            </fo:root>"

        Dim driver As FonetDriver = FonetDriver.Make()
        driver.Render(New StringReader(xslFo), 
            New FileStream("custom.pdf", FileMode.Create))
    End Sub
End Class

' NuGet: Install-Package Fonet
Imports Fonet
Imports Fonet.Render.Pdf
Imports System.IO

Class Program
    Shared Sub Main()
        ' fo.net settings are configured in XSL-FO markup
        Dim xslFo As String = "<?xml version='1.0' encoding='utf-8'?>
            <fo:root xmlns:fo='http://www.w3.org/1999/XSL/Format'>
                <fo:layout-master-set>
                    <fo:simple-page-master master-name='A4' 
                        page-height='297mm' page-width='210mm'
                        margin-top='20mm' margin-bottom='20mm'
                        margin-left='25mm' margin-right='25mm'>
                        <fo:region-body/>
                    </fo:simple-page-master>
                </fo:layout-master-set>
                <fo:page-sequence master-reference='A4'>
                    <fo:flow flow-name='xsl-region-body'>
                        <fo:block font-size='14pt'>Custom PDF</fo:block>
                    </fo:flow>
                </fo:page-sequence>
            </fo:root>"

        Dim driver As FonetDriver = FonetDriver.Make()
        driver.Render(New StringReader(xslFo), 
            New FileStream("custom.pdf", FileMode.Create))
    End Sub
End Class

Después (IronPDF con HTML):

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Engines.Chrome;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;
        renderer.RenderingOptions.MarginLeft = 25;
        renderer.RenderingOptions.MarginRight = 25;
        
        string html = "<h1 style='font-size:14pt'>Custom PDF</h1>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("custom.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Engines.Chrome;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;
        renderer.RenderingOptions.MarginLeft = 25;
        renderer.RenderingOptions.MarginRight = 25;
        
        string html = "<h1 style='font-size:14pt'>Custom PDF</h1>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("custom.pdf");
    }
}

' NuGet: Install-Package IronPdf
Imports IronPdf
Imports IronPdf.Engines.Chrome

Module Program
    Sub Main()
        Dim renderer As New ChromePdfRenderer()
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
        renderer.RenderingOptions.MarginTop = 20
        renderer.RenderingOptions.MarginBottom = 20
        renderer.RenderingOptions.MarginLeft = 25
        renderer.RenderingOptions.MarginRight = 25

        Dim html As String = "<h1 style='font-size:14pt'>Custom PDF</h1>"
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("custom.pdf")
    End Sub
End Module

' NuGet: Install-Package IronPdf
Imports IronPdf
Imports IronPdf.Engines.Chrome

Module Program
    Sub Main()
        Dim renderer As New ChromePdfRenderer()
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
        renderer.RenderingOptions.MarginTop = 20
        renderer.RenderingOptions.MarginBottom = 20
        renderer.RenderingOptions.MarginLeft = 25
        renderer.RenderingOptions.MarginRight = 25

        Dim html As String = "<h1 style='font-size:14pt'>Custom PDF</h1>"
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("custom.pdf")
    End Sub
End Module

IronPDF ofrece opciones programáticas de presentación en lugar de incrustar la configuración en el marcado XML.

Ejemplo 3: URL a PDF

Antes (fo.net - no compatible):

// NuGet: Install-Package Fonet
using Fonet;
using System.IO;
using System.Net;

class Program
{
    static void Main()
    {
        // fo.net does not support URL rendering directly
        // Must manually download, convert HTML to XSL-FO, then render
        string url = "https://example.com";
        string html = new WebClient().DownloadString(url);
        
        // Manual conversion from HTML to XSL-FO required (complex)
        string xslFo = ConvertHtmlToXslFo(html); // Not built-in
        
        FonetDriver driver = FonetDriver.Make();
        driver.Render(new StringReader(xslFo), 
            new FileStream("webpage.pdf", FileMode.Create));
    }
    
    static string ConvertHtmlToXslFo(string html)
    {
        // Custom implementation required - extremely complex
        throw new System.NotImplementedException();
    }
}

// NuGet: Install-Package Fonet
using Fonet;
using System.IO;
using System.Net;

class Program
{
    static void Main()
    {
        // fo.net does not support URL rendering directly
        // Must manually download, convert HTML to XSL-FO, then render
        string url = "https://example.com";
        string html = new WebClient().DownloadString(url);
        
        // Manual conversion from HTML to XSL-FO required (complex)
        string xslFo = ConvertHtmlToXslFo(html); // Not built-in
        
        FonetDriver driver = FonetDriver.Make();
        driver.Render(new StringReader(xslFo), 
            new FileStream("webpage.pdf", FileMode.Create));
    }
    
    static string ConvertHtmlToXslFo(string html)
    {
        // Custom implementation required - extremely complex
        throw new System.NotImplementedException();
    }
}

' NuGet: Install-Package Fonet
Imports Fonet
Imports System.IO
Imports System.Net

Class Program
    Shared Sub Main()
        ' fo.net does not support URL rendering directly
        ' Must manually download, convert HTML to XSL-FO, then render
        Dim url As String = "https://example.com"
        Dim html As String = New WebClient().DownloadString(url)
        
        ' Manual conversion from HTML to XSL-FO required (complex)
        Dim xslFo As String = ConvertHtmlToXslFo(html) ' Not built-in
        
        Dim driver As FonetDriver = FonetDriver.Make()
        driver.Render(New StringReader(xslFo), 
            New FileStream("webpage.pdf", FileMode.Create))
    End Sub
    
    Shared Function ConvertHtmlToXslFo(html As String) As String
        ' Custom implementation required - extremely complex
        Throw New System.NotImplementedException()
    End Function
End Class

' NuGet: Install-Package Fonet
Imports Fonet
Imports System.IO
Imports System.Net

Class Program
    Shared Sub Main()
        ' fo.net does not support URL rendering directly
        ' Must manually download, convert HTML to XSL-FO, then render
        Dim url As String = "https://example.com"
        Dim html As String = New WebClient().DownloadString(url)
        
        ' Manual conversion from HTML to XSL-FO required (complex)
        Dim xslFo As String = ConvertHtmlToXslFo(html) ' Not built-in
        
        Dim driver As FonetDriver = FonetDriver.Make()
        driver.Render(New StringReader(xslFo), 
            New FileStream("webpage.pdf", FileMode.Create))
    End Sub
    
    Shared Function ConvertHtmlToXslFo(html As String) As String
        ' Custom implementation required - extremely complex
        Throw New System.NotImplementedException()
    End Function
End Class

Después (IronPDF - soporte integrado):

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
        pdf.SaveAs("webpage.pdf")
    End Sub
End Class

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
        pdf.SaveAs("webpage.pdf")
    End Sub
End Class

La conversión de URL a PDF es una de las ventajas más significativas de esta migración a .net.IronPDF se encarga de ello de forma nativa con ejecución completa de JavaScript. Más información sobre Conversión de URL a PDF.

Ejemplo 4: Encabezados y pies de página

Antes (fo.net con XSL-FO):

<fo:static-content flow-name="xsl-region-before">
    <fo:block text-align="center" font-size="10pt">
        Company Name - Confidential
    </fo:block>
</fo:static-content>

<fo:static-content flow-name="xsl-region-after">
    <fo:block text-align="right" font-size="10pt">
        Page <fo:page-number/> of <fo:page-number-citation ref-id="last-page"/>
    </fo:block>
</fo:static-content>

<fo:static-content flow-name="xsl-region-before">
    <fo:block text-align="center" font-size="10pt">
        Company Name - Confidential
    </fo:block>
</fo:static-content>

<fo:static-content flow-name="xsl-region-after">
    <fo:block text-align="right" font-size="10pt">
        Page <fo:page-number/> of <fo:page-number-citation ref-id="last-page"/>
    </fo:block>
</fo:static-content>

XML

Después (IronPDF):

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center; font-size:10pt;'>Company Name - Confidential</div>",
    DrawDividerLine = true
};

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:right; font-size:10pt;'>Page {page} of {total-pages}</div>",
    DrawDividerLine = true
};

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center; font-size:10pt;'>Company Name - Confidential</div>",
    DrawDividerLine = true
};

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:right; font-size:10pt;'>Page {page} of {total-pages}</div>",
    DrawDividerLine = true
};

Imports System

renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
    .HtmlFragment = "<div style='text-align:center; font-size:10pt;'>Company Name - Confidential</div>",
    .DrawDividerLine = True
}

renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
    .HtmlFragment = "<div style='text-align:right; font-size:10pt;'>Page {page} of {total-pages}</div>",
    .DrawDividerLine = True
}

Imports System

renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
    .HtmlFragment = "<div style='text-align:center; font-size:10pt;'>Company Name - Confidential</div>",
    .DrawDividerLine = True
}

renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
    .HtmlFragment = "<div style='text-align:right; font-size:10pt;'>Page {page} of {total-pages}</div>",
    .DrawDividerLine = True
}

IronPDF sustituye las complejas definiciones de regiones XSL-FO por sencillos encabezados y pies de página HTML.

Ejemplo 5: Seguridad de PDF

Antes (fo.net):

// fo.net has very limited PDF security options
// Must use post-processing with another library

// fo.net has very limited PDF security options
// Must use post-processing with another library

' fo.net has very limited PDF security options
' Must use post-processing with another library

' fo.net has very limited PDF security options
' Must use post-processing with another library

Después (IronPDF):

using IronPdf;

public byte[] GenerateSecurePdf(string html)
{
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html);

    // Set metadata
    pdf.MetaData.Title = "Confidential Report";
    pdf.MetaData.Author = "Company Name";

    // Password protection
    pdf.SecuritySettings.OwnerPassword = "owner123";
    pdf.SecuritySettings.UserPassword = "user456";

    // Restrict permissions
    pdf.SecuritySettings.AllowUserCopyPasteContent = false;
    pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.NoPrint;
    pdf.SecuritySettings.AllowUserEdits = IronPdf.Security.PdfEditSecurity.NoEdit;

    return pdf.BinaryData;
}

using IronPdf;

public byte[] GenerateSecurePdf(string html)
{
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html);

    // Set metadata
    pdf.MetaData.Title = "Confidential Report";
    pdf.MetaData.Author = "Company Name";

    // Password protection
    pdf.SecuritySettings.OwnerPassword = "owner123";
    pdf.SecuritySettings.UserPassword = "user456";

    // Restrict permissions
    pdf.SecuritySettings.AllowUserCopyPasteContent = false;
    pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.NoPrint;
    pdf.SecuritySettings.AllowUserEdits = IronPdf.Security.PdfEditSecurity.NoEdit;

    return pdf.BinaryData;
}

Imports IronPdf

Public Function GenerateSecurePdf(html As String) As Byte()
    Dim renderer = New ChromePdfRenderer()
    Dim pdf = renderer.RenderHtmlAsPdf(html)

    ' Set metadata
    pdf.MetaData.Title = "Confidential Report"
    pdf.MetaData.Author = "Company Name"

    ' Password protection
    pdf.SecuritySettings.OwnerPassword = "owner123"
    pdf.SecuritySettings.UserPassword = "user456"

    ' Restrict permissions
    pdf.SecuritySettings.AllowUserCopyPasteContent = False
    pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.NoPrint
    pdf.SecuritySettings.AllowUserEdits = IronPdf.Security.PdfEditSecurity.NoEdit

    Return pdf.BinaryData
End Function

Imports IronPdf

Public Function GenerateSecurePdf(html As String) As Byte()
    Dim renderer = New ChromePdfRenderer()
    Dim pdf = renderer.RenderHtmlAsPdf(html)

    ' Set metadata
    pdf.MetaData.Title = "Confidential Report"
    pdf.MetaData.Author = "Company Name"

    ' Password protection
    pdf.SecuritySettings.OwnerPassword = "owner123"
    pdf.SecuritySettings.UserPassword = "user456"

    ' Restrict permissions
    pdf.SecuritySettings.AllowUserCopyPasteContent = False
    pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.NoPrint
    pdf.SecuritySettings.AllowUserEdits = IronPdf.Security.PdfEditSecurity.NoEdit

    Return pdf.BinaryData
End Function

Consideraciones sobre el rendimiento

Reutilizar ChromePdfRenderer

Para obtener un rendimiento óptimo durante la migración de fo .NET , reutilice la instancia ChromePdfRenderer:

// GOOD - Reuse the renderer
public class PdfService
{
    private static readonly ChromePdfRenderer _renderer = new ChromePdfRenderer();

    public byte[] Generate(string html) => _renderer.RenderHtmlAsPdf(html).BinaryData;
}

// BAD - Creating new instance each time
public byte[] GenerateBad(string html)
{
    var renderer = new ChromePdfRenderer();  // Wasteful
    return renderer.RenderHtmlAsPdf(html).BinaryData;
}

// GOOD - Reuse the renderer
public class PdfService
{
    private static readonly ChromePdfRenderer _renderer = new ChromePdfRenderer();

    public byte[] Generate(string html) => _renderer.RenderHtmlAsPdf(html).BinaryData;
}

// BAD - Creating new instance each time
public byte[] GenerateBad(string html)
{
    var renderer = new ChromePdfRenderer();  // Wasteful
    return renderer.RenderHtmlAsPdf(html).BinaryData;
}

Imports System

' GOOD - Reuse the renderer
Public Class PdfService
    Private Shared ReadOnly _renderer As New ChromePdfRenderer()

    Public Function Generate(html As String) As Byte()
        Return _renderer.RenderHtmlAsPdf(html).BinaryData
    End Function
End Class

' BAD - Creating new instance each time
Public Function GenerateBad(html As String) As Byte()
    Dim renderer As New ChromePdfRenderer() ' Wasteful
    Return renderer.RenderHtmlAsPdf(html).BinaryData
End Function

Imports System

' GOOD - Reuse the renderer
Public Class PdfService
    Private Shared ReadOnly _renderer As New ChromePdfRenderer()

    Public Function Generate(html As String) As Byte()
        Return _renderer.RenderHtmlAsPdf(html).BinaryData
    End Function
End Class

' BAD - Creating new instance each time
Public Function GenerateBad(html As String) As Byte()
    Dim renderer As New ChromePdfRenderer() ' Wasteful
    Return renderer.RenderHtmlAsPdf(html).BinaryData
End Function

Ayudante de conversión de unidades

fo.net XSL-FO utiliza varias unidades.IronPDF utiliza milímetros para los márgenes. Aquí tienes una clase de ayuda:

public static class UnitConverter
{
    public static double InchesToMm(double inches) => inches * 25.4;
    public static double PointsToMm(double points) => points * 0.352778;
    public static double PicasToMm(double picas) => picas * 4.233;
    public static double CmToMm(double cm) => cm * 10;
}

// Usage
renderer.RenderingOptions.MarginTop = UnitConverter.InchesToMm(1);  // 1 inch

public static class UnitConverter
{
    public static double InchesToMm(double inches) => inches * 25.4;
    public static double PointsToMm(double points) => points * 0.352778;
    public static double PicasToMm(double picas) => picas * 4.233;
    public static double CmToMm(double cm) => cm * 10;
}

// Usage
renderer.RenderingOptions.MarginTop = UnitConverter.InchesToMm(1);  // 1 inch

Public Module UnitConverter
    Public Function InchesToMm(inches As Double) As Double
        Return inches * 25.4
    End Function

    Public Function PointsToMm(points As Double) As Double
        Return points * 0.352778
    End Function

    Public Function PicasToMm(picas As Double) As Double
        Return picas * 4.233
    End Function

    Public Function CmToMm(cm As Double) As Double
        Return cm * 10
    End Function
End Module

' Usage
renderer.RenderingOptions.MarginTop = UnitConverter.InchesToMm(1)  ' 1 inch

Public Module UnitConverter
    Public Function InchesToMm(inches As Double) As Double
        Return inches * 25.4
    End Function

    Public Function PointsToMm(points As Double) As Double
        Return points * 0.352778
    End Function

    Public Function PicasToMm(picas As Double) As Double
        Return picas * 4.233
    End Function

    Public Function CmToMm(cm As Double) As Double
        Return cm * 10
    End Function
End Module

' Usage
renderer.RenderingOptions.MarginTop = UnitConverter.InchesToMm(1)  ' 1 inch

Solución de problemas

Cuestión 1: Diferencias de tamaño de página

Problema: el tamaño de la página PDF se ve diferente después de la migración a .NET .

Solución: Asigne correctamente las dimensiones de la página XSL-FO:

// XSL-FO: page-height='11in' page-width='8.5in' (Letter)
renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;

// XSL-FO: page-height='297mm' page-width='210mm' (A4)
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

// Custom size (in mm)
renderer.RenderingOptions.SetCustomPaperSize(210, 297);

// XSL-FO: page-height='11in' page-width='8.5in' (Letter)
renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;

// XSL-FO: page-height='297mm' page-width='210mm' (A4)
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

// Custom size (in mm)
renderer.RenderingOptions.SetCustomPaperSize(210, 297);

' XSL-FO: page-height='11in' page-width='8.5in' (Letter)
renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter

' XSL-FO: page-height='297mm' page-width='210mm' (A4)
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4

' Custom size (in mm)
renderer.RenderingOptions.SetCustomPaperSize(210, 297)

' XSL-FO: page-height='11in' page-width='8.5in' (Letter)
renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter

' XSL-FO: page-height='297mm' page-width='210mm' (A4)
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4

' Custom size (in mm)
renderer.RenderingOptions.SetCustomPaperSize(210, 297)

Edición 2: Mapeo de fo:block a HTML

Problema: No estoy seguro de en qué debería convertirse <fo:block>.

Solución: utilice HTML semántico apropiado:

Encabezados: <h1> hasta <h6>
Párrafos: <p>
Contenedores genéricos: <div>
Texto en línea: <span>

Cuestión 3: Fuentes no coincidentes

Problema: Las fuentes se ven diferentes a la salida de fo .NET .

Solución: utilice fuentes web o especifique fuentes del sistema en CSS:

<style>
    @import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');
    body { font-family: 'Roboto', Arial, sans-serif; }
</style>

<style>
    @import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');
    body { font-family: 'Roboto', Arial, sans-serif; }
</style>

HTML

Cuestión 4: Los números de página no funcionan

Problema: <fo:page-number/> no funciona.

Solución: utilice marcadores de posición IronPDF en encabezados y pies de página:

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center;'>Page {page} of {total-pages}</div>",
    MaxHeight = 15  // mm
};

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center;'>Page {page} of {total-pages}</div>",
    MaxHeight = 15  // mm
};

Imports System

renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
    .HtmlFragment = "<div style='text-align:center;'>Page {page} of {total-pages}</div>",
    .MaxHeight = 15 ' mm
}

Imports System

renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
    .HtmlFragment = "<div style='text-align:center;'>Page {page} of {total-pages}</div>",
    .MaxHeight = 15 ' mm
}

Cumplimiento normativo en España: fo.NET no puede satisfacer los requisitos legales

La obsolescencia técnica de fo.NET se combina en España con una barrera regulatoria insalvable. Los desarrolladores de software de facturación deben ser conscientes de que XSL-FO no dispone de las primitivas necesarias para cumplir con la normativa española vigente.

VeriFactu (Real Decreto-Ley 15/2025)

VeriFactu obliga a que cada PDF de factura incluya la leyenda VERI*FACTU y una huella encadenada que vincula cada factura con la anterior, asegurando la trazabilidad ante la AEAT. Estos requisitos implican manipular el contenido del PDF de forma programática —añadir texto, metadatos y hashes—, algo que el motor XSL-FO de fo.NET no soporta. Los proveedores que incumplan el RDL 15/2025 se exponen a sanciones de hasta 150.000 € anuales.

TicketBAI (Bizkaia, Gipuzkoa y Araba)

El régimen TicketBAI en el País Vasco exige firmar digitalmente cada factura usando XAdES y adjuntarla como PDF firmado con PAdES conforme a eIDAS, con certificados reconocidos por la FNMT u otras autoridades de certificación. fo.NET no implementa firma digital de ningún tipo.

Crea y Crece y Facturae XML

La Ley Crea y Crece exige la emisión de facturas electrónicas B2B en formato Facturae XML, bajo el estándar EN 16931 y el perfil CIUS-ES, con posibilidad de envío a través de FACe o el SII de la AEAT. IronPDF permite incrustar Facturae XML en documentos PDF/A-3, cubriendo este requisito con una única biblioteca.

LOPDGDD y procesamiento on-premise

La LOPDGDD y la supervisión de la AEPD exigen que los datos personales de las facturas se procesen con garantías adecuadas. IronPDF opera completamente on-premise, sin transferir contenido a servicios externos, lo que simplifica la evaluación de impacto de protección de datos.

Lista de comprobación de la migración

Pre-Migración

Catalogar todos los archivos de plantilla XSL-FO (.fo, .xslfo)
Dimensiones de la página del documento y márgenes utilizados
Configuraciones de encabezado/pie de página de notas (fo:static-content)
Identificar estructuras y estilos de tablas
Realizar una copia de seguridad del proyecto en el control de versiones
Obtener la clave de licencia de IronPDF

Migración de paquetes

Eliminar el paquete Fonet o FO.NET: dotnet remove package Fonet
Instalar el paquete IronPdf: dotnet add package IronPdf
Actualizar las importaciones de espacios de nombres de Fonet a IronPdf
Establecer la clave de licencia de IronPDF al inicio

Migración de código

Reemplace FonetDriver.Make() con new ChromePdfRenderer()
Reemplace driver.Render() con renderer.RenderHtmlAsPdf()
Actualizar la salida de archivos de los streams a pdf.SaveAs()
Reemplazar los controladores de eventos de error con try/catch
Convertir fo:static-content a HtmlHeaderFooter
Reemplace <fo:page-number/> con el marcador de posición {page}

Pruebas

Comparar la apariencia de salida con los PDF .NET originales
Verificar las dimensiones y márgenes de la página
Verificar encabezados y pies de página
Validar números de página
Representación de la tabla de pruebas
Verificar la carga de la imagen

Posmigración

Eliminar los archivos de plantilla .fo y .xslfo
Eliminar código y utilidades relacionadas con fo.net
Actualización de la documentación

Para profundizar en la superficie de IronPDF utilizada anteriormente, consulte la referencia de la API de IronPDF.

Por favor nota: FO.NET, Fonet y Apache FOP son marcas comerciales de sus respectivos propietarios. Este sitio no está afiliado con, respaldado por, ni patrocinado por el proyecto FO.NET ni por la Apache Software Foundation. Todos los nombres de productos, logotipos y marcas son propiedad de sus respectivos dueños. Las comparaciones tienen fines meramente informativos y reflejan información disponible públicamente en el momento de su redacción.

Curtis Chau

Chatea con el equipo de ingeniería ahora

Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

...