Convertir HTML a PDF en C#

En esta guía, encontrará información sobre cómo convertir un documento HTML a un formato de archivo de formato de documento portátil (PDF) utilizando la biblioteca Aspose.HTML for .NET. Vamos a cubrir en detalle cómo convertir HTML a PDF usando los métodos ConvertHTML() de la clase Converter y cómo aplicar los parámetros PdfSaveOptions y ICreateStreamProvider.

Para continuar siguiendo este tutorial, debe instalar y configurar la biblioteca Aspose.HTML for .NET en su proyecto C#. Nuestros ejemplos de código le ayudan a convertir HTML a PDF y generar archivos PDF utilizando la biblioteca C#.

HTML a PDF mediante una sola línea de código

La conversión de HTML a PDF es muy popular. Para realizar esta función, Aspose.HTML for .NET ofrece los métodos estáticos de la clase Converter como una forma comprensible y sencilla de convertir código HTML en un archivo PDF literalmente con una sola línea de código.

// Invoke the ConvertHTML() method to convert HTML to PDF
Converter.ConvertHTML(@"<h1>Convert HTML to PDF!</h1>", ".", new PdfSaveOptions(), Path.Combine(OutputDir, "convert-with-single-line.pdf"));

Convertidor HTML en línea

Puede comprobar la funcionalidad de la API Aspose.HTML y convertir HTML en tiempo real. Cargue HTML desde el sistema de archivos local, seleccione el formato de salida y ejecute el ejemplo. En el ejemplo, las opciones de guardar están configuradas de forma predeterminada. Recibirá inmediatamente el resultado en un archivo separado.

Si desea convertir HTML a PDF mediante programación, consulte los siguientes ejemplos de código C#.

Convertir HTML a PDF en C#

Cualquier conversión de HTML a PDF que desee realizar implica cargar un documento HTML y guardarlo en formato PDF. Puede cargar HTML desde un archivo, código HTML, secuencia o URL (consulte el artículo Creación de un documento HTML). Pueden ser diferentes escenarios, pero se pueden realizar con algunos pasos necesarios:

1. Cargue un archivo HTML usando uno de los constructores HTMLDocument() de la clase HTMLDocument. En el ejemplo utilizamos el constructor HTMLDocument(string) que inicializa un documento HTML a partir de un archivo.
2. Cree un nuevo objeto PdfSaveOptions.
3. Utilice el método ConvertHTML() de la clase Converter para guardar HTML como un archivo PDF. Debe pasar HTMLDocument, PdfSaveOptions y la ruta del archivo de salida al método ConvertHTML() para convertir HTML a PDF.

Para continuar en esta guía, necesitaremos algún archivo HTML con el que trabajar. Aquí hay un archivo HTML de muestra que usaremos en el siguiente ejemplo de C#: spring.html. Si lo abres en tu navegador, deberías ver:

Eche un vistazo al siguiente fragmento de código C# que muestra el proceso de conversión de HTML a PDF para el archivo spring.html.

// Prepare a path to a source HTML file
string documentPath = Path.Combine(DataDir, "spring.html");

// Prepare a path to save the converted file
string savePath = Path.Combine(OutputDir, "spring-output.pdf");

// Initialize an HTML document from the file
using var document = new HTMLDocument(documentPath);

// Initialize PdfSaveOptions 
var options = new PdfSaveOptions();

// Convert HTML to PDF
Converter.ConvertHTML(document, options, savePath);

Opciones de guardado – PdfSaveOptions

La funcionalidad de creación de PDF se puede mejorar con opciones de guardado según sus necesidades. Aspose.HTML permite convertir HTML a PDF usando opciones de guardado predeterminadas o personalizadas. El uso de PdfSaveOptions le permite personalizar el proceso de renderizado; puede especificar el tamaño de la página, márgenes, permisos de archivos, CSS, etc.

Property	Description
JpegQuality	Specifies the quality of JPEG compression for images. The default value is 95.
Css	Gets a CssOptions object which is used for configuration of CSS properties processing.
DocumentInfo	This property contains information about the output PDF document.
BackgroundColor	This property sets the color that will fill the background of every page. By default, this property is Transparent.
PageSetup	This property gets a page setup object and uses it for configuration output page-set.
HorizontalResolution	Sets horizontal resolution for output images in pixels per inch. The default value is 300 dpi.
VerticalResolution	Sets vertical resolution for output images in pixels per inch. The default value is 300 dpi.
Encryption	This property gets or sets encryption details. If it is not set, then no encryption will be performed.

Para obtener más información sobre PdfSaveOptions, lea el artículo Convertidores de ajuste fino. Puede descargar los ejemplos completos y los archivos de datos desde GitHub.

Convierta HTML a PDF en C# usando PdfSaveOptions

Con Aspose.HTML, puede convertir archivos mediante programación con control total sobre una amplia gama de parámetros de conversión. Para convertir HTML a PDF con la especificación PdfSaveOptions, debe seguir algunos pasos:

1. Cargue un archivo HTML usando uno de los constructores HTMLDocument() de la clase HTMLDocument.
2. Cree un nuevo objeto PdfSaveOptions y especifique las propiedades requeridas. La clase PdfSaveOptions proporciona numerosas propiedades que le brindan control total sobre una amplia gama de parámetros y mejoran el proceso de conversión de HTML a formato PDF.
3. Utilice el método ConvertHTML() de la clase Converter para guardar HTML como un archivo PDF. El método ConvertHTML() toma el document, las options, la ruta del archivo de salida savePath y realiza la operación de conversión.

El siguiente ejemplo muestra cómo utilizar PdfSaveOptions y crear un archivo PDF con opciones de guardado personalizadas:

// Prepare a path to a source HTML file
string documentPath = Path.Combine(DataDir, "drawing.html");

// Prepare a path to save the converted file
string savePath = Path.Combine(OutputDir, "drawing-options.pdf");

// Initialize an HTML document from the file
using var document = new HTMLDocument(documentPath);

// Initialize PdfSaveOptions. Set up the page-size 600x300 pixels, margins, resolutions and change the background color to AliceBlue 
var options = new PdfSaveOptions()
{                
    HorizontalResolution = 200,
    VerticalResolution = 200,
    BackgroundColor = System.Drawing.Color.AliceBlue,
    JpegQuality = 100
};
options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(600, 300), new Margin(20, 10, 10, 10));           

// Convert HTML to PDF
Converter.ConvertHTML(document, options, savePath);

En el ejemplo anterior, usamos:

• Propiedad JpegQuality que le permite especificar la calidad de la compresión JPEG para imágenes;
• Propiedad BackgroundColor que establece el color que rellenará el fondo. El BackgroundColor predeterminado es Transparent;
• Propiedades HorizontalResolution y VerticalResolution que establecen la resolución horizontal/vertical para las imágenes de salida en píxeles por pulgada. De forma predeterminada, estas propiedades son 300 ppp;
• Propiedad PageSetup que especifica el page size y los margins.

La conversión de HTML a PDF se puede personalizar de forma flexible para obtener el resultado deseado. En los siguientes artículos, encontrará respuestas a preguntas populares sobre la conversión de HTML a PDF:

• ¿Cómo cambiar el tamaño del documento durante la conversión desde HTML?
• Cómo aplanar un PDF
• Establecer carpeta de fuentes para representar HTML a PDF
• Combinar HTML con PDF
• Tiempo de espera de red para convertir HTML

Proveedores de flujo de salida – Output Stream Providers

Si es necesario guardar archivos en el almacenamiento remoto (por ejemplo, nube, base de datos, etc.), puede implementar la interfaz ICreateStreamProvider para tener control manual sobre el proceso de creación de archivos. Esta interfaz está diseñada como un objeto de devolución de llamada para crear una secuencia al comienzo del documento/página (según el formato de salida) y liberar la secuencia creada inicialmente después de renderizar el documento/página.

La biblioteca Aspose.HTML C# permite realizar la clase MemoryStreamProvider como una implementación personalizada de la interfaz ICreateStreamProvider. La clase MemoryStreamProvider proporciona objetos C# MemoryStream como flujos de salida para escribir datos, que se pueden almacenar en la memoria como un flujo:

class MemoryStreamProvider : Aspose.Html.IO.ICreateStreamProvider
{
    // List of MemoryStream objects created during the document rendering
    public List<MemoryStream> Streams { get; } = new List<MemoryStream>();

    public Stream GetStream(string name, string extension)
    {
        // This method is called when only one output stream is required, for instance for XPS, PDF or TIFF formats
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public Stream GetStream(string name, string extension, int page)
    {
        // This method is called when the creation of multiple output streams are required. For instance, during the rendering HTML to list of image files (JPG, PNG, etc.)
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public void ReleaseStream(Stream stream)
    {
        // Here you can release the stream filled with data and, for instance, flush it to the hard-drive
    }

    public void Dispose()
    {
        // Releasing resources
        foreach (var stream in Streams)
            stream.Dispose();
    }
}

Aspose.HTML for .NET proporciona varios tipos de formatos de salida para operaciones de renderizado. Algunos de estos formatos producen un único archivo de salida (por ejemplo, PDF, XPS), mientras que otros crean varios archivos (formatos de imagen JPG, PNG, etc.).

El siguiente código C# demuestra cómo utilizar la clase MemoryStreamProvider y la biblioteca Aspose.HTML for .NET para convertir HTML a PDF y guardar el resultado en un archivo.

// Create an instance of MemoryStreamProvider
using var streamProvider = new MemoryStreamProvider();

// Initialize an HTML document
using var document = new HTMLDocument(@"<h1>Convert HTML to PDF File Format!</h1>", ".");

// Convert HTML to PDF using the MemoryStreamProvider
Converter.ConvertHTML(document, new PdfSaveOptions(), streamProvider);

// Get access to the memory stream that contains the result data
var memory = streamProvider.Streams.First();
memory.Seek(0, SeekOrigin.Begin);

// Flush the result data to the output file
using (FileStream fs = File.Create(Path.Combine(OutputDir, "stream-provider.pdf")))
{
    memory.CopyTo(fs);
}

Puede descargar los ejemplos completos y los archivos de datos desde GitHub.

Descargue nuestra biblioteca Aspose.HTML for .NET que le permite convertir con éxito, rápida y fácilmente sus documentos HTML, MHTML, EPUB, SVG y Markdown a los formatos más populares.

Aspose.HTML ofrece un Convertidor de HTML a PDF gratuito en línea que convierte HTML a PDF con alta calidad, fácil y rápido. ¡Simplemente cargue, convierta sus archivos y obtenga el resultado en unos segundos!