Cómo linealizar PDFs usando C# con IronPDF

¿Cómo se guarda un PDF en formato lineal?

Guardar un documento como un PDF linearizado con IronPDF es un proceso rápido y sencillo. Antes de empezar, asegúrese de haber instalado IronPDF a través de NuGet o mediante uno de los otros métodos de instalación disponibles.

En este ejemplo, convertiremos una cadena HTML en un PDF usando RenderHtmlAsPdf. Para documentos HTML más complejos, quizá quieras explorar las funciones de conversión de HTML a PDF de IronPDF. Luego, guardaremos el objeto PdfDocument como un PDF linealizado usando el método de instancia SaveAsLinearized. Este método toma un argumento de cadena para la ruta del archivo de salida.

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf.cs

using IronPdf;

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

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

// Get the PDF binary data
var pdfBytes = pdf.BinaryData;

// Save the PDF binary data as a linearized PDF file
PdfDocument.SaveAsLinearized(pdfBytes, "linearize-from-bytes.pdf");

Imports IronPdf

' Instantiate Renderer
Dim renderer As New ChromePdfRenderer()

' Create a PDF from an HTML string using VB.NET
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Pdf Bytes</h1>")

' Get the PDF binary data
Dim pdfBytes = pdf.BinaryData

' Save the PDF binary data as a linearized PDF file
PdfDocument.SaveAsLinearized(pdfBytes, "linearize-from-bytes.pdf")

El proceso de linealización reestructura el formato interno del PDF, colocando la información crítica al principio del archivo. Esto permite la descarga y renderización progresivas, lo que resulta especialmente beneficioso cuando se sirven PDF a través de aplicaciones web.

¿Qué aspecto tiene el resultado?

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf.cs

using IronPdf;

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

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

// Get the PDF binary data
var pdfBytes = pdf.BinaryData;

// Save the PDF binary data as a linearized PDF file
PdfDocument.SaveAsLinearized(pdfBytes, "linearize-from-bytes.pdf");

Imports IronPdf

' Instantiate Renderer
Dim renderer As New ChromePdfRenderer()

' Create a PDF from an HTML string using VB.NET
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Pdf Bytes</h1>")

' Get the PDF binary data
Dim pdfBytes = pdf.BinaryData

' Save the PDF binary data as a linearized PDF file
PdfDocument.SaveAsLinearized(pdfBytes, "linearize-from-bytes.pdf")

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf-stream.cs

using IronPdf;
using System.IO;

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

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

// Get the PDF binary data
var pdfBytes = pdf.BinaryData;

// Transform PDF bytes to a MemoryStream
MemoryStream memoryStream = new MemoryStream(pdfBytes);

// Save the MemoryStream as a linearized PDF
PdfDocument.SaveAsLinearized(memoryStream, "linearize-stream.pdf");

Imports IronPdf
Imports System.IO

' Instantiate Renderer
Dim renderer As New ChromePdfRenderer()

' Create a PDF from an HTML string using VB.NET
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Memory Stream</h1>")

' Get the PDF binary data
Dim pdfBytes As Byte() = pdf.BinaryData

' Transform PDF bytes to a MemoryStream
Dim memoryStream As New MemoryStream(pdfBytes)

' Save the MemoryStream as a linearized PDF
PdfDocument.SaveAsLinearized(memoryStream, "linearize-stream.pdf")

¿Cómo puedo comprobar si un PDF está linealizado?

Además de verificar las propiedades del documento en un visor de PDF, como Adobe Acrobat, para ver si un PDF está linealizado, IronPDF también proporciona una forma de verificar esto programáticamente con el método IsLinearized. El método toma un parámetro de cadena para la ruta del archivo y un segundo parámetro de cadena opcional para la contraseña si el PDF está encriptado. Esta capacidad de verificación es esencial para garantizar la calidad y puede integrarse en flujos de trabajo de pruebas automatizadas.

En este ejemplo, utilizaremos los archivos de salida de los tres ejemplos anteriores para comprobar si están linealizados, e incluiremos un cuarto PDF no linealizado para mostrar el comportamiento del método. Para conocer técnicas más avanzadas de manipulación y verificación de PDF, explore el completo conjunto de funciones de IronPDF.

:path=/static-assets/pdf/content-code-examples/how-to/linearize-pdf-test.cs

using IronPdf;
using System;

// First example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize.pdf"));

// Second example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize-from-bytes.pdf"));

// Third example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize-stream.pdf"));

// Fourth example Non-Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("sample.pdf"));

Imports IronPdf
Imports System

' First example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize.pdf"))

' Second example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize-from-bytes.pdf"))

' Third example Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("linearize-stream.pdf"))

' Fourth example Non-Linearized PDF
Console.WriteLine(PdfDocument.IsLinearized("sample.pdf"))

¿Cuáles son los resultados?

Como puede ver, los primeros tres ejemplos devuelven true, mientras que el último PDF, que no está linealizado, devuelve false.

Por favor notaNo hay ningún método para verificar si un objeto PdfDocument en sí está linearizado. Esto se debe a que cuando un archivo PDF se abre y se carga en un objeto, su estructura especial linearizada se pierde. Por la misma razón, no hay ningún método para devolver un PDF linearizado como un arreglo de bytes. Esta característica linearizada solo existe como un archivo guardado en disco.

Prácticas recomendadas para PDF linealizados

Cuando trabaje con PDF linealizados, tenga en cuenta estas prácticas recomendadas:

1. Consideraciones sobre el tamaño del archivo: La linealización puede aumentar ligeramente el tamaño del archivo debido al formato reestructurado. Utilice las funciones de compresión de IronPDF para optimizar el tamaño de los archivos cuando sea necesario.

2. Despliegue web: Los PDF linealizados son ideales para aplicaciones web. Configure su servidor web para que admita solicitudes de rango de bytes para maximizar los beneficios de la linealización.

3. Pruebas de rendimiento: Pruebe siempre los PDF linealizados en el entorno de destino. La mejora del rendimiento es más notable con archivos grandes en conexiones lentas.

4. Compatibilidad: Aunque la mayoría de los visores de PDF modernos admiten PDF linealizados, asegúrese de la compatibilidad con los visores preferidos de sus usuarios.

Para obtener más información sobre estrategias de optimización y técnicas avanzadas de manejo de PDF, consulte Documentación sobre opciones de renderizado de IronPDF.