How to Convert HTML String to PDF in C#
IronPDF convierte cadenas HTML en documentos PDF en C# utilizando un motor de renderizado de Chrome, compatible con todo el contenido HTML5, CSS3 y JavaScript con una sola línea de código para conversiones básicas. La biblioteca ofrece potentes funciones para crear PDF manteniendo una fidelidad de renderizado perfecta.
IronPDF permite a los desarrolladores crear documentos PDF fácilmente en C#, F# y VB.NET for .NET Core y .NET Framework. IronPDF permite convertir cualquier cadena HTML en un PDF, y el proceso de conversión utiliza una versión totalmente funcional del motor Google Chromium. Esto garantiza que el contenido HTML aparezca exactamente como lo haría en un navegador web moderno, lo que lo hace ideal para generar informes, facturas y documentos a partir de contenido HTML dinámico.
Inicio rápido: Convertir cadena HTML a PDF en segundosTransforme cadenas HTML en archivos PDF con IronPDF. Esta guía muestra cómo convertir una cadena HTML en un documento PDF en C# con un código mínimo. Perfecto para desarrolladores que necesiten integrar funciones de renderizado de PDF en sus proyectos.
-
1Install IronPDF with NuGet Package Manager
-
2Copie y ejecute este fragmento de código.
IronPdf.ChromePdfRenderer.StaticRenderHtmlAsPdf("<p>Hello World</p>").SaveAs("string-to-pdf.pdf");C# -
3Despliegue para probar en su entorno real
Comienza a usar IronPDF en tu proyecto hoy mismo con una prueba gratuita
Flujo de trabajo mínimo (5 pasos)
- Descargar la biblioteca IronPDF C# de NuGet
- Instanciar el renderizador de PDF y pasar la cadena HTML
- Configurar BasePath para recursos externos en PDF
- Configure las RenderingOptions para ajustar el PDF de salida
- Guardar y descargar el PDF generado
¿Cómo convierto una cadena HTML simple a PDF?
Aquí hay un ejemplo de cómo IronPDF renderiza una cadena HTML en un PDF usando el método RenderHtmlAsPdf. El parámetro es una cadena HTML que se va a renderizar como PDF. Este método es parte de la clase ChromePdfRenderer, que proporciona un control extenso sobre las opciones de renderizado para tus necesidades de generación de PDF.
using IronPdf;
// 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");Imports IronPdf
' Instantiate Renderer
Private renderer = New ChromePdfRenderer()
' Create a PDF from a HTML string using C#
Private pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")
' Export to a file or Stream
pdf.SaveAs("output.pdf")El método RenderHtmlAsPdf retorna un objeto PdfDocument, que contiene información del PDF y proporciona métodos para manipular el PDF, incluyendo fusionar PDFs, añadir marcas de agua y establecer opciones de seguridad.
RenderHtmlAsPdfAsync para evitar bloquear hilos. El PdfDocument retornado implementa IDisposable, por lo que envuélvelo en un bloque using para escenarios de alto rendimiento. ChromePdfRenderer es seguro para hilos y puede ser instanciado una vez y reutilizado en las peticiones para un mejor rendimiento.Cuando se obtiene una cadena HTML de una fuente externa y necesitas deshabilitar el acceso al disco local o las solicitudes de origen cruzado, configura IronPdf.Installation.EnableWebSecurity en verdadero antes de renderizar. Se trata de una configuración global estática, no de una propiedad de instancia del renderizador.
// Enable web security before rendering untrusted HTML
IronPdf.Installation.EnableWebSecurity = true;' Enable web security before rendering untrusted HTML
IronPdf.Installation.EnableWebSecurity = TruePara contenido HTML complejo que incluya estilos CSS, mejore sus cadenas HTML con estilos en línea o haga referencia a hojas de estilo externas mediante la función Base URLs & Asset Encoding:
// Example with inline CSS
var styledHtml = @"
<html>
<head>
<style>
body { font-family: Arial, sans-serif; margin: 40px; }
h1 { color: #333; border-bottom: 2px solid #0066cc; }
p { line-height: 1.6; }
</style>
</head>
<body>
<h1>Professional Report</h1>
<p>This PDF was generated from HTML with custom styling.</p>
</body>
</html>";
using var styledPdf = renderer.RenderHtmlAsPdf(styledHtml);
styledPdf.SaveAs("styled-output.pdf");Dim styledHtml As String = "
<html>
<head>
<style>
body { font-family: Arial, sans-serif; margin: 40px; }
h1 { color: #333; border-bottom: 2px solid #0066cc; }
p { line-height: 1.6; }
</style>
</head>
<body>
<h1>Professional Report</h1>
<p>This PDF was generated from HTML with custom styling.</p>
</body>
</html>"
Using styledPdf = renderer.RenderHtmlAsPdf(styledHtml)
styledPdf.SaveAs("styled-output.pdf")
End Using¿Qué aspecto tiene el PDF generado?
Este es el archivo que produjo el código:
El PDF generado mantiene el formato y el estilo exactos del HTML, por lo que es perfecto para generar informes en PDF o convertir contenido web en documentos listos para imprimir.
Mi biblioteca favorita de este tipo es IronPDF. Permite una manipulación rápida y eficiente de archivos PDF. También tiene muchas funciones valiosas, como exportar al formato PDF/A y firmar documentos PDF digitalmente.
IronOCR significa que podemos ahorrar $40,000 anualmente en el procesamiento manual, mientras mejoramos la productividad y liberamos recursos para tareas de alto impacto. Lo recomendaría encarecidamente.
El Iron Suite juega un papel crucial en nuestras operaciones. Estas son herramientas que aumentan la eficiencia en toda la empresa, incluyendo la creación de planos y la mejora en la gestión de inventario.
¿Cómo puedo incluir recursos externos al convertir HTML a PDF?
Este ejemplo muestra IronPDF cargando una imagen externa desde una BasePath opcional. Configurar la propiedad BaseUrlOrPath proporciona la ruta de archivo relativa o el contexto de URL para hipervínculos, imágenes, CSS, y archivos JavaScript. Esto es esencial cuando se trabaja con imágenes en archivos PDF o cuando es necesario hacer referencia a recursos externos.
using IronPdf;
// Instantiate Renderer
var renderer = new ChromePdfRenderer();
// 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");Imports IronPdf
' Instantiate Renderer
Private renderer = New ChromePdfRenderer()
' 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
Private myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", "C:\site\assets\")
myAdvancedPdf.SaveAs("html-with-assets.pdf")Para situaciones avanzadas que impliquen diseños complejos o contenido dinámico, utilice la compatibilidad de IronPDF con representación de JavaScript:
// Example with JavaScript-generated content
var jsHtml = @"
<html>
<head>
<script>
window.onload = function() {
document.getElementById('dynamic').innerHTML =
'Generated on: ' + new Date().toLocaleString();
};
</script>
</head>
<body>
<h1>Dynamic Content Example</h1>
<div id='dynamic'></div>
</body>
</html>";
// Configure rendering to wait for JavaScript execution
renderer.RenderingOptions.WaitFor.RenderDelay(500); // milliseconds
using var dynamicPdf = renderer.RenderHtmlAsPdf(jsHtml, @"C:\site\");
dynamicPdf.SaveAs("dynamic-content.pdf");Imports System.IO
' Example with JavaScript-generated content
Dim jsHtml As String = "
<html>
<head>
<script>
window.onload = function() {
document.getElementById('dynamic').innerHTML =
'Generated on: ' + new Date().toLocaleString();
};
</script>
</head>
<body>
<h1>Dynamic Content Example</h1>
<div id='dynamic'></div>
</body>
</html>"
' Configure rendering to wait for JavaScript execution
renderer.RenderingOptions.WaitFor.RenderDelay(500) ' milliseconds
Using dynamicPdf = renderer.RenderHtmlAsPdf(jsHtml, "C:\site\")
dynamicPdf.SaveAs("dynamic-content.pdf")
End UsingAl trabajar con activos externos, es posible que tenga que gestionar la autenticación o cabeceras especiales. IronPDF soporta esto a través de la funcionalidad HTTP Request Header, permitiéndole incluir tokens de autorización o cabeceras personalizadas cuando obtiene recursos.
¿Por qué es importante establecer BasePath para los recursos externos?
Este es el archivo que produjo el código:
Configurar correctamente BasePath asegura que todas las referencias relativas en tu HTML se resuelvan correctamente. Sin ella, IronPDF no puede localizar recursos externos como imágenes, hojas de estilo o secuencias de comandos. Esto es especialmente importante cuando:
- Convirtiendo HTML que referencia recursos del sistema de archivos local
- Trabajando con sistemas de gestión de contenido que utilizan URLs relativas
- Migrando contenido web existente a formato PDF
- Creando plantillas que utilizan activos compartidos
Para los recursos basados en web, utilice una URL completa como ruta base:
// Using a web URL as base path
var webBasedPdf = renderer.RenderHtmlAsPdf(
"<link rel='stylesheet' href='/styles/main.css'><h1>Web Content</h1>",
"https://mywebsite.com"
);' Using a web URL as base path
Dim webBasedPdf = renderer.RenderHtmlAsPdf(
"<link rel='stylesheet' href='/styles/main.css'><h1>Web Content</h1>",
"https://mywebsite.com"
)Para obtener un control adicional sobre el proceso de generación de PDF, explore la amplia documentación de IronPDF sobre margenes personalizados, orientación de la página y compresión de PDF para optimizar sus archivos de salida para diversos casos de uso.
Preguntas Frecuentes
¿Cómo convierto una simple cadena HTML a PDF en C#?
Puede convertir una cadena HTML a PDF utilizando la clase ChromePdfRenderer de IronPDF con el método RenderHtmlAsPdf. Basta con instanciar el renderizador, pasar la cadena HTML al método y guardar el objeto PdfDocument resultante. IronPDF utiliza un motor de renderizado de Chrome para garantizar una fidelidad perfecta.
¿Qué motor de renderizado utiliza la conversión de HTML a PDF?
IronPDF utiliza una versión totalmente funcional del motor Google Chromium para la conversión de HTML a PDF. Esto garantiza que su contenido HTML, incluyendo HTML5, CSS3 y JavaScript, aparezca exactamente como lo haría en un navegador web moderno.
¿Puedo convertir HTML con estilo CSS a PDF?
Sí, IronPDF permite convertir HTML con estilos CSS a PDF. Puede utilizar estilos en línea directamente en su cadena HTML o hacer referencia a hojas de estilo externas utilizando la función Base URLs & Asset Encoding para garantizar la correcta representación del contenido con estilo.
¿Cuál es la forma más rápida de convertir HTML a PDF?
La forma más rápida es utilizar el método estático de IronPDF: IronPdf.ChromePdfRenderer.StaticRenderHtmlAsPdf("Tu HTML").SaveAs("output.pdf"). Esta única línea de código convierte tu cadena HTML y la guarda como un archivo PDF.
¿Cómo se gestionan los activos externos al convertir cadenas HTML?
IronPDF le permite configurar la ruta base para los activos externos en su PDF. Esto asegura que las imágenes, hojas de estilo y otros recursos referenciados en su HTML se carguen correctamente durante el proceso de conversión.
¿Puedo personalizar la salida PDF al convertir desde HTML?
Sí, IronPDF proporciona amplias RenderingOptions para ajustar con precisión su salida PDF. Puede controlar el tamaño de página, los márgenes, los encabezados, los pies de página y muchos otros aspectos del PDF generado a través de la clase ChromePdfRenderer.
¿Qué puedo hacer con el PDF generado después de la conversión?
El objeto PdfDocument de IronPDF proporciona numerosos métodos para la manipulación de PDF, incluida la fusión de PDF, la adición de marcas de agua, la configuración de opciones de seguridad y mucho más. El PDF convertido puede guardarse en el disco, transmitirse o procesarse según sea necesario.
¿Cómo se gestiona la seguridad al convertir HTML de fuentes externas?
Al convertir HTML de fuentes externas, IronPDF le permite establecer la propiedad EnableWebSecurity en true en el ChromePdfRenderer. Esto desactiva el acceso al disco local y las solicitudes de origen cruzado para mejorar la seguridad.
How can I ensure my external web resources are correctly referenced in IronPDF?
To ensure external web resources are correctly referenced, specify the correct `BasePath` or use a full URL as the base path for web-based content. This includes images, stylesheets, and scripts.
What is the role of `ChromePdfRenderer` in IronPDF?
The `ChromePdfRenderer` in IronPDF is responsible for converting HTML to PDF. It uses a fully functional version of the Google Chromium engine to ensure accurate rendering as seen in a web browser.
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.
