Crear PDF en C# a partir de Archivo HTML

Ejemplo 1

Para evaluar un ejemplo más realista, imagina una factura HTML que necesita convertirse en un PDF. Aquí está el código de cómo hacer eso.

Nota: Puedes encontrar la factura HTML bajo el proyecto IronPDFDemo.DemoWebSite (~/Static/TestInvoice1.html). Por favor, ten en cuenta que la factura tiene CSS personalizado para el tipo de medio "print".

La factura original se ve así en el navegador:

Para convertir esto en un archivo PDF, se utilizan códigos similares al ejemplo de HolaMundo anterior, siendo la diferencia el archivo HTML de origen.

// Read HTML from file
var html = File.ReadAllText(Path.Combine(Directory.GetCurrentDirectory(), "TestInvoice1.html"));
var chromePdfRenderer = new ChromePdfRenderer();
using var pdf = chromePdfRenderer.RenderHtmlAsPdf(html);
pdf.SaveAs(Path.Combine(Directory.GetCurrentDirectory(), "ChromePdfRendererExample1.Pdf"));

// Read HTML from file
var html = File.ReadAllText(Path.Combine(Directory.GetCurrentDirectory(), "TestInvoice1.html"));
var chromePdfRenderer = new ChromePdfRenderer();
using var pdf = chromePdfRenderer.RenderHtmlAsPdf(html);
pdf.SaveAs(Path.Combine(Directory.GetCurrentDirectory(), "ChromePdfRendererExample1.Pdf"));

' Read HTML from file
Dim html = File.ReadAllText(Path.Combine(Directory.GetCurrentDirectory(), "TestInvoice1.html"))
Dim chromePdfRenderer As New ChromePdfRenderer()
Dim pdf = chromePdfRenderer.RenderHtmlAsPdf(html)
pdf.SaveAs(Path.Combine(Directory.GetCurrentDirectory(), "ChromePdfRendererExample1.Pdf"))

El resultado es:

Generar un archivo PDF desde HTML

¡Se ve genial! Por favor, encuentra el ejemplo de código bajo el proyecto IronPDFDemo.RenderHtmlAdPdfDemo.

También consulta esta pregunta sobre Cómo usar documentos HTML o cadenas con arreglos de bytes en IronPDF

Ejemplo 2

Esta sección ayudará a personalizar el PDF resultante del Ejemplo 1. Por ejemplo, añadirá márgenes personalizados, un encabezado con el título del documento, un pie de página con la fecha de creación y números de página y algo de CSS personalizado para el tipo de medio "print" que una factura estándar tiene. Para hacer esto, se inicializa una instancia de ChromePdfRenderOptions y se pasa al constructor de ChromePdfRenderer.

// Configure rendering options with margins, headers, and footers
var pdfRenderingOptions = new ChromePdfRenderOptions()
{
    MarginTop = 50,
    MarginBottom = 50,
    TextHeader = new TextHeaderFooter()
    {
        CenterText = "{pdf-title}",
        DrawDividerLine = true,
        FontSize = 16
    },
    TextFooter = new TextHeaderFooter()
    {
        LeftText = "{date} {time}",
        RightText = "Page {page} of {total-pages}",
        DrawDividerLine = true,
        FontSize = 14
    },
    CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
};

var chromePdfRenderer = new ChromePdfRenderer(pdfRenderingOptions);

// Configure rendering options with margins, headers, and footers
var pdfRenderingOptions = new ChromePdfRenderOptions()
{
    MarginTop = 50,
    MarginBottom = 50,
    TextHeader = new TextHeaderFooter()
    {
        CenterText = "{pdf-title}",
        DrawDividerLine = true,
        FontSize = 16
    },
    TextFooter = new TextHeaderFooter()
    {
        LeftText = "{date} {time}",
        RightText = "Page {page} of {total-pages}",
        DrawDividerLine = true,
        FontSize = 14
    },
    CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
};

var chromePdfRenderer = new ChromePdfRenderer(pdfRenderingOptions);

' Configure rendering options with margins, headers, and footers
Dim pdfRenderingOptions = New ChromePdfRenderOptions() With {
	.MarginTop = 50,
	.MarginBottom = 50,
	.TextHeader = New TextHeaderFooter() With {
		.CenterText = "{pdf-title}",
		.DrawDividerLine = True,
		.FontSize = 16
	},
	.TextFooter = New TextHeaderFooter() With {
		.LeftText = "{date} {time}",
		.RightText = "Page {page} of {total-pages}",
		.DrawDividerLine = True,
		.FontSize = 14
	},
	.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
}

Dim chromePdfRenderer As New ChromePdfRenderer(pdfRenderingOptions)

Consejo: En lugar de pasar opciones como parámetro en el constructor, puedes establecer el campo correspondiente para una instancia de ChromePdfRenderer:

var chromePdfRenderer = new ChromePdfRenderer();
chromePdfRenderer.RenderingOptions = pdfRenderingOptions;

var chromePdfRenderer = new ChromePdfRenderer();
chromePdfRenderer.RenderingOptions = pdfRenderingOptions;

Dim chromePdfRenderer As New ChromePdfRenderer()
chromePdfRenderer.RenderingOptions = pdfRenderingOptions

Nota: Las características de encabezado y pie de página fusionan la funcionalidad, lo que significa que todos los campos de fusión ({page}, {total-pages}, {url}, {date}, {time}, {html-title}, {pdf-title}) se pueden poblar con los datos correspondientes.

El resto del código es el mismo que en el Ejemplo 1. El resultado es:

Generar una factura con encabezado y pie de página

Los márgenes, encabezados, pies de página y CSS personalizados para el tipo de medio "print" están ahora en su lugar. Por favor, encuentra el ejemplo de código bajo el proyecto IronPDFDemo.RenderHtmlAdPdfDemo. Se pueden encontrar más configuraciones en la referencia API de IronPDF.

Configuración

Para ejecutar ejemplos de esta sección necesitas alojar IronPDFDemo.DemoWebSite localmente. Para hacer eso en IIS Express:

1. Navega a DemoWebSite
2. Haz clic derecho > Establecer como Proyecto de Inicio
3. Inicia sin depuración (Ctrl+F5)
4. Navega a tu {baseurl}/Static/TestInvoice1.html para asegurarte de que está funcionando. Esta es la URL http://localhost:51169/Static/TestInvoice1.html (será la misma para ti si no cambias la configuración correspondiente del proyecto).

Ejemplo 1

En esta sección, la factura del DemoWebSite alojado se convierte en un PDF usando el mismo código que el ejemplo de HolaMundo. La diferencia reside en la URL alojada:

// URL of the hosted invoice webpage
var uri = new Uri("http://localhost:51169/Static/TestInvoice1.html");
var urlToPdf = new ChromePdfRenderer();
using var pdf = urlToPdf.RenderUrlAsPdf(uri);
pdf.SaveAs(Path.Combine(Directory.GetCurrentDirectory(), "UrlToPdfExample1.Pdf"));

// URL of the hosted invoice webpage
var uri = new Uri("http://localhost:51169/Static/TestInvoice1.html");
var urlToPdf = new ChromePdfRenderer();
using var pdf = urlToPdf.RenderUrlAsPdf(uri);
pdf.SaveAs(Path.Combine(Directory.GetCurrentDirectory(), "UrlToPdfExample1.Pdf"));

' URL of the hosted invoice webpage
Dim uri As New Uri("http://localhost:51169/Static/TestInvoice1.html")
Dim urlToPdf = New ChromePdfRenderer()
Dim pdf = urlToPdf.RenderUrlAsPdf(uri)
pdf.SaveAs(Path.Combine(Directory.GetCurrentDirectory(), "UrlToPdfExample1.Pdf"))

El resultado es:

Generar un sitio web alojado en un PDF

Esto es genial y se ve como se esperaba. Por favor, encuentra el ejemplo de código dentro del proyecto IronPDFDemo.RenderUrlAsPdfDemo.

Ejemplo 2

Muchos sitios web a menudo están protegidos por un método de autenticación. Esta sección usa un nombre de usuario y contraseña proporcionados durante el proceso de renderización de un archivo PDF con alguna personalización: márgenes personalizados, un encabezado con el título del documento, un pie de página con la fecha de creación y páginas, y CSS personalizado para el tipo de medio "print". La URL para la factura está en http://localhost:51169/Invoice.

Acceder a http://localhost:51169/Invoice resulta en el formulario "Autenticación requerida":

Formulario de autenticación requerida

Nota: Las credenciales son "testUser"/"testPassword".

Entonces, ¿cómo evitar la autenticación? Estableciendo HttpLoginCredentials:

// URL of the protected invoice webpage
var uri = new Uri("http://localhost:51169/Invoice");

// Configure renderer with login credentials to bypass authentication
var urlToPdf = new ChromePdfRenderer
{
    RenderingOptions = new ChromePdfRenderOptions()
    {
        MarginTop = 50,
        MarginBottom = 50,
        TextHeader = new TextHeaderFooter()
        {
            CenterText = "{pdf-title}",
            DrawDividerLine = true,
            FontSize = 16
        },
        TextFooter = new TextHeaderFooter()
        {
            LeftText = "{date} {time}",
            RightText = "Page {page} of {total-pages}",
            DrawDividerLine = true,
            FontSize = 14
        },
        CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
    },

    // Set login credentials to bypass basic authentication
    LoginCredentials = new HttpLoginCredentials()
    {
        NetworkUsername = "testUser",
        NetworkPassword = "testPassword"
    }
};

using var pdf = urlToPdf.RenderUrlAsPdf(uri);
pdf.SaveAs(Path.Combine(Directory.GetCurrentDirectory(), "UrlToPdfExample2.Pdf"));

// URL of the protected invoice webpage
var uri = new Uri("http://localhost:51169/Invoice");

// Configure renderer with login credentials to bypass authentication
var urlToPdf = new ChromePdfRenderer
{
    RenderingOptions = new ChromePdfRenderOptions()
    {
        MarginTop = 50,
        MarginBottom = 50,
        TextHeader = new TextHeaderFooter()
        {
            CenterText = "{pdf-title}",
            DrawDividerLine = true,
            FontSize = 16
        },
        TextFooter = new TextHeaderFooter()
        {
            LeftText = "{date} {time}",
            RightText = "Page {page} of {total-pages}",
            DrawDividerLine = true,
            FontSize = 14
        },
        CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
    },

    // Set login credentials to bypass basic authentication
    LoginCredentials = new HttpLoginCredentials()
    {
        NetworkUsername = "testUser",
        NetworkPassword = "testPassword"
    }
};

using var pdf = urlToPdf.RenderUrlAsPdf(uri);
pdf.SaveAs(Path.Combine(Directory.GetCurrentDirectory(), "UrlToPdfExample2.Pdf"));

' URL of the protected invoice webpage
Dim uri As New Uri("http://localhost:51169/Invoice")

' Configure renderer with login credentials to bypass authentication
Dim urlToPdf = New ChromePdfRenderer With {
	.RenderingOptions = New ChromePdfRenderOptions() With {
		.MarginTop = 50,
		.MarginBottom = 50,
		.TextHeader = New TextHeaderFooter() With {
			.CenterText = "{pdf-title}",
			.DrawDividerLine = True,
			.FontSize = 16
		},
		.TextFooter = New TextHeaderFooter() With {
			.LeftText = "{date} {time}",
			.RightText = "Page {page} of {total-pages}",
			.DrawDividerLine = True,
			.FontSize = 14
		},
		.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
	},
	.LoginCredentials = New HttpLoginCredentials() With {
		.NetworkUsername = "testUser",
		.NetworkPassword = "testPassword"
	}
}

Dim pdf = urlToPdf.RenderUrlAsPdf(uri)
pdf.SaveAs(Path.Combine(Directory.GetCurrentDirectory(), "UrlToPdfExample2.Pdf"))

Nota: Se utiliza la misma personalización que para el Example2 de ChromePdfRenderer.

El resultado es:

Generar un sitio HTML con credenciales a un archivo PDF

Todo está en su lugar. Por favor, encuentra un ejemplo de código bajo el proyecto IronPDFDemo.RenderUrlAsPdfDemo. Si te preguntas cómo sería el resultado sin HttpLoginCredentials, aquí está:

Generar un archivo PDF vacío sin credenciales

Consulta también el Tutorial de .NET HTML a PDF de Jean

Además, IronPDF también puede interactuar con PDF de diferentes maneras:

• Extraer imágenes y texto de PDFs usando OCR
• Editar el contenido HTML de la web que has convertido
• Mejorar la configuración de primer plano y fondo del archivo PDF
• Añadir firmas digitales a tus PDFs
• Auto-llenar tus formularios PDF usando herramientas de IronPDF