Cómo crear nuevos PDF en C# con IronPDF
IronPDF permite a los desarrolladores C# crear nuevos documentos PDF programáticamente utilizando el constructor PdfDocument para PDFs en blanco, importando PDFs existentes desde varias fuentes, o convirtiendo HTML, imágenes, RTF, Markdown y XML al formato PDF. Tanto si se trata de crear informes empresariales, generar facturas o crear documentos dinámicos a partir de contenido web, IronPDF proporciona las herramientas para generar PDF en aplicaciones .NET.
En el marco regulatorio español, la creación programática de PDFs adquiere especial relevancia para la generación de documentos fiscales y empresariales conformes. Los ISVs que desarrollan software de facturación bajo los requisitos de VeriFactu o la ley Crea y Crece (que establece la obligatoriedad de la facturación electrónica B2B en España para 2027-2028) necesitan generar PDFs estructurados que acompañen a los XMLs de factura electrónica para archivo y entrega al receptor. IronPDF es la solución C# de referencia para esta generación documental en el ecosistema .NET español.
Inicio rápido: crea tu primer PDF en C#
// 1. Install IronPDF from NuGet
// 2. Create a blank PDF
var pdf = new IronPdf.PdfDocument(270, 270);
// 3. Or convert HTML to PDF
var renderer = new IronPdf.ChromePdfRenderer();
var pdfFromHtml = renderer.RenderHtmlAsPdf("<h1>Hello PDF!</h1>");
// 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf");
// 1. Install IronPDF from NuGet
// 2. Create a blank PDF
var pdf = new IronPdf.PdfDocument(270, 270);
// 3. Or convert HTML to PDF
var renderer = new IronPdf.ChromePdfRenderer();
var pdfFromHtml = renderer.RenderHtmlAsPdf("<h1>Hello PDF!</h1>");
// 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf");
' 1. Install IronPDF from NuGet
' 2. Create a blank PDF
Dim pdf As New IronPdf.PdfDocument(270, 270)
' 3. Or convert HTML to PDF
Dim renderer As New IronPdf.ChromePdfRenderer()
Dim pdfFromHtml As IronPdf.PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello PDF!</h1>")
' 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf")
-
Instala IronPDF con el Administrador de Paquetes NuGet
PM > Install-Package IronPdf -
Copie y ejecute este fragmento de código.
new IronPdf.PdfDocument { DefaultPageSize = new IronPdf.PageSize(270,270) }.SaveAs("blankPage.pdf"); -
Despliegue 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 IronPDF de NuGet para crear nuevos PDF
- Utilice el constructor PdfDocument para crear un PDF en blanco
- Importar un PDF existente desde un archivo, URL, matriz de bytes o JSON
- Convertir múltiples formatos a PDF, como HTML, RTF, Markdown, imágenes y XML
- Exportar el documento PDF
¿Cómo crear un ejemplo de PDF en blanco?
Hay múltiples maneras de crear un objeto PDF. Comience con el método más sencillo, que sólo requiere la anchura y la altura del PDF. Este constructor PdfDocument crea un nuevo PDF en blanco, listo para personalización y uso. Las dimensiones se especifican en puntos (1/72 de pulgada), lo que permite un dimensionado preciso para diversas aplicaciones como etiquetas, tarjetas de visita o formatos de documentos personalizados.
Para los desarrolladores que necesitan un mayor control sobre las dimensiones de la página, IronPDF admite tamaños de papel personalizados y varios formatos predefinidos, incluidos los tamaños Carta, A4 y Legal. Puede establecer diferentes orientaciones utilizando las funciones de orientación de página.
¿Qué parámetros son necesarios para un PDF en blanco?
:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs.cs
using IronPdf;
PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
Imports IronPdf
Dim pdf As New PdfDocument(270, 270)
pdf.SaveAs("blankPage.pdf")
Una vez que haya creado un PDF en blanco, puede mejorarlo añadiendo encabezados y pies de página, aplicando marcas de agua o insertando imágenes.
¿Cómo puedo importar un PDF desde un archivo?
Antes de que un PDF pueda ser modificado o convertido, primero debe ser importado como un objeto PdfDocument. Utilice el método estático FromFile de la clase PdfDocument para lograr esto. La importación de PDF desde JSON, matrices de bytes, flujos y URL es compatible con la misma clase. Esta flexibilidad se adapta a situaciones en las que es necesario fusionar varios PDF, extraer páginas específicas o modificar documentos existentes.
Cuando se trabaja con archivos PDF almacenados en servicios en la nube, IronPDF se integra con Azure Blob Storage y otras plataformas en la nube. Puede cargar PDF desde flujos de memoria para un procesamiento eficaz sin acceso al sistema de archivos.
¿Qué métodos de importación están disponibles?
:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs-from-file.cs
using IronPdf;
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");
pdf.SaveAs("export.pdf");
Imports IronPdf
Private pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")
pdf.SaveAs("export.pdf")
Tras la importación, puede realizar varias operaciones como extraer texto e imágenes, añadir anotaciones o aplicar firmas digitales.
¿Cómo se convierte desde otros formatos?
Además de los métodos mencionados anteriormente para obtener un objeto PdfDocument, puede convertir varios formatos a PDF. El método más sofisticado es la conversión de HTML a PDF, que renderiza el HTML junto con todos sus activos, incluidos JavaScript, imágenes, enlaces y estilos CSS, utilizando el motor de Chrome. Además de HTML, puedes convertir otros formatos en PDF, como imágenes, RTF, Markdown y XML.
El motor de renderizado Chrome de IronPDF garantiza conversiones pixel-perfect que mantienen la fidelidad visual de tu contenido fuente. El renderizador es compatible con estándares web modernos, como HTML5, CSS3 y marcos de JavaScript, por lo que resulta adecuado para convertir páginas web complejas o vistas de Razor en PDF.
El siguiente fragmento de código demuestra la conversión de HTML a PDF. La conversión a HTML utiliza el motor de renderizado de IronPDF para mantener la integridad del contenido con todo el estilo aplicado. También puede convertir Markdown a PDF, XML a PDF y imágenes a PDF.
¿Qué opciones de renderizado debo configurar?
:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs-from-html.cs
using IronPdf;
// Instantiate Renderer
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1800);
renderer.RenderingOptions.WaitFor.RenderDelay(5000);
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
// Create a PDF from a URL or local file path
var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
// Export to a file or Stream
pdf.SaveAs("url.pdf");
Imports IronPdf
' Instantiate Renderer
Private renderer = New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1800)
renderer.RenderingOptions.WaitFor.RenderDelay(5000)
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
' Create a PDF from a URL or local file path
Dim pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/")
' Export to a file or Stream
pdf.SaveAs("url.pdf")
¿Qué formatos se pueden convertir a PDF?
IronPDF admite la conversión desde múltiples formatos:
- HTML a PDF: Convierta cadenas HTML, archivos HTML, o URLs con soporte completo de CSS y JavaScript
- Imagen a PDF: Convierta imágenes JPG, PNG, GIF, BMP y TIFF
- Formatos de documentos: Convierta archivos DOCX y RTF
- Lenguajes de marcado: Convierte Markdown y XML
- Páginas ASP.NET: Convierta ASPX y páginas Razor
El PDF generado puede ser visto usando un visor de PDF embebido, como se muestra aquí. El iframe que aparece a continuación muestra el PDF resultante.
Para escenarios avanzados, explore renderización de sitios WebGL, manejo de retrasos de JavaScript, o implementación de registro personalizado para solucionar problemas de conversión.
Generación de PDFs para documentos empresariales españoles
En el contexto normativo y empresarial español, crear nuevos PDFs con IronPDF es especialmente útil para los siguientes tipos de documentos:
-
Facturas electrónicas VeriFactu y Facturae: Las empresas españolas obligadas a emitir facturas verificables bajo VeriFactu deben generar, junto al XML de la factura, un PDF de representación gráfica para el receptor. IronPDF permite crear estos PDFs desde cero a partir de los datos estructurados del sistema de facturación, aplicando el diseño corporativo y los campos obligatorios (NIF emisor, NIF receptor, número de factura, base imponible, cuota de IVA). El incumplimiento de los requisitos de VeriFactu puede conllevar sanciones de hasta 150.000 €/año para los ISVs.
-
Declaraciones tributarias para la AEAT: Los sistemas de gestión fiscal que preparan el contenido de declaraciones periódicas (liquidaciones de IVA, retenciones de IRPF, declaraciones informativas) generan documentos PDF de borrador para revisión interna antes del envío electrónico a la AEAT a través de sus servicios telemáticos.
-
Documentos para la plataforma FACe (B2G): Las empresas que facturan a las administraciones públicas a través de FACe acompañan el XML Facturae con un PDF de representación generado programáticamente. IronPDF convierte plantillas HTML con los datos de la factura al formato PDF requerido para su adjunto en la plataforma.
-
Informes de auditoría bajo la ley Crea y Crece: Con la llegada de la obligatoriedad del formato Facturae para transacciones B2B (ley Crea y Crece, prevista para 2027-2028), las empresas que implanten sistemas de facturación electrónica B2B necesitarán generar PDFs de auditoría y registros de transacciones para cumplir con los requisitos de conservación documental.
- Certificados y documentos firmados con eIDAS: Los documentos PDF creados con IronPDF sirven como base para aplicar firmas electrónicas PAdES reconocidas bajo el reglamento eIDAS, incluyendo las que utilizan certificados emitidos por la FNMT o validados mediante el sistema Cl@ve. Esta combinación es el estándar para la firma de contratos y documentos legales en el entorno empresarial español.
Preguntas Frecuentes
¿Cómo instalo la biblioteca para empezar a crear PDF en C#?
Instala IronPDF a través del Administrador de paquetes NuGet en Visual Studio. Puedes buscar «IronPDF» en la interfaz de usuario del Administrador de paquetes NuGet o utilizar la Consola del Administrador de paquetes con el comando «Install-Package IronPdf». Una vez instalado, puedes empezar inmediatamente a crear archivos PDF utilizando el constructor PdfDocument o la clase ChromePdfRenderer.
¿Cuál es la forma más rápida de crear un documento PDF en blanco?
La forma más rápida de crear un PDF en blanco con IronPDF es utilizando el constructor PdfDocument con los parámetros de ancho y alto: new IronPdf.PdfDocument(270, 270).SaveAs('blank.pdf'). Las dimensiones se especifican en puntos (1/72 de pulgada). También se pueden establecer tamaños de página y orientaciones personalizados, así como añadir metadatos como el autor y el título.
¿Puedo convertir contenido HTML a formato PDF?
Sí, IronPDF sobresale en la conversión de HTML a PDF utilizando la clase ChromePdfRenderer. Simplemente cree una instancia de renderizador y use el método RenderHtmlAsPdf(): var renderer = new IronPdf.ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf('. Esto soporta la renderización completa de HTML5, CSS3 y JavaScript.Hello PDF!
')
¿Qué formatos de archivo se pueden convertir a PDF?
IronPDF admite la conversión de múltiples formatos a PDF, incluyendo HTML, imágenes (JPG, PNG, GIF, BMP), documentos RTF, archivos Markdown y XML. Cada formato tiene métodos específicos; por ejemplo, utilice RenderHtmlAsPdf() para HTML, ImageToPdf() para imágenes y renderizadores especializados para otros formatos.
¿Cómo puedo añadir metadatos personalizados a mis documentos PDF?
Después de crear un PdfDocument con IronPDF, acceda a la propiedad MetaData para establecer información personalizada: pdf.MetaData.Author = 'Su nombre'; pdf.MetaData.Title = 'Título del documento'; pdf.MetaData.CreationDate = DateTime.Now. Estos metadatos ayudan a organizar los documentos y a facilitar su búsqueda.
¿Puedo importar archivos PDF existentes de diferentes fuentes?
IronPDF permite importar archivos PDF existentes desde diversas fuentes, incluyendo archivos locales, URL, matrices de bytes o datos JSON. Utilice PdfDocument.FromFile() para archivos locales, FromUrl() para archivos PDF basados en web o FromBytes() para datos de matrices de bytes. Esto le permite trabajar con documentos PDF existentes y modificarlos.
¿Cómo puedo añadir varias páginas a un documento PDF?
Utilice el método AppendPage() en su objeto PdfDocument para añadir páginas en blanco de forma dinámica. IronPDF también permite insertar páginas en posiciones específicas, copiar páginas de otros archivos PDF y fusionar varios documentos PDF. Cada nueva página hereda el tamaño de página predeterminado, a menos que se especifique lo contrario.
¿Qué tamaños y orientaciones de página se admiten?
IronPDF admite tamaños de papel personalizados especificados en puntos, así como formatos predefinidos como Carta, A4 y Legal. Puede establecer la orientación de la página (vertical u horizontal) y crear documentos con tamaños de página mixtos. Las dimensiones personalizadas le ofrecen un control preciso para aplicaciones especializadas como etiquetas o tarjetas de visita.
¿Cómo puedo generar PDFs de facturas conformes con VeriFactu usando IronPDF en C#?
Con IronPDF puede renderizar una plantilla HTML de factura que incluya todos los campos obligatorios de VeriFactu (NIF emisor/receptor, importe, tipo impositivo, número de serie, código QR) usando ChromePdfRenderer.RenderHtmlAsPdf(). El PDF resultante sirve como representación visual de la factura VeriFactu junto al XML de trazabilidad.
¿Qué obligaciones establece la Ley Crea y Crece respecto a los PDFs de facturas en España?
La Ley 18/2022 (Crea y Crece) obliga a todas las empresas y autónomos españoles a emitir facturas electrónicas en formato estructurado (Facturae o VeriFactu). IronPDF puede generar el PDF de cortesía adjunto al XML Facturae, así como documentos PDF/A para cumplir el requisito de conservación de 4 años establecido por la AEAT.

