Como linearizar e otimizar PDFs usando C# com IronPDF

Como faço para salvar um PDF linearizado?

Salvar um documento como PDF linearizado com o IronPDF é um processo rápido e fácil. Antes de começar, certifique-se de ter instalado o IronPDF via NuGet ou por meio de um dos outros métodos de instalação disponíveis.

Neste exemplo, vamos renderizar uma string HTML em um PDF usando RenderHtmlAsPdf. Para documentos HTML mais complexos, você pode explorar os recursos de conversão de HTML para PDF do IronPDF . Em seguida, salvaremos o objeto PdfDocument como um PDF linearizado usando o método de instância SaveAsLinearized. Este método recebe como argumento uma string que representa o caminho do arquivo de saída.

: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")

O processo de linearização reestrutura o formato interno do PDF, colocando informações críticas no início do arquivo. Isso permite o download e a renderização progressivos, o que é particularmente benéfico ao disponibilizar PDFs por meio de aplicativos da web.

Qual é a aparência do 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")

Como posso verificar se um PDF está linearizado?

Além de verificar as propriedades do documento em um visualizador de PDF, como o Adobe Acrobat, para ver se um PDF está linearizado, o IronPDF também fornece uma maneira de verificar isso programaticamente com o método IsLinearized. O método recebe um parâmetro de string para o caminho do arquivo e um segundo parâmetro de string opcional para a senha, caso o PDF esteja criptografado. Essa capacidade de verificação é essencial para a garantia da qualidade e pode ser integrada a fluxos de trabalho de testes automatizados.

Neste exemplo, usaremos os arquivos de saída dos três exemplos acima para testar se eles estão linearizados e incluiremos um quarto PDF não linearizado para demonstrar o comportamento do método. Para técnicas mais avançadas de manipulação e verificação de PDFs, explore o conjunto abrangente de recursos do 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"))

Quais são os resultados?

Como você pode ver, os três primeiros exemplos retornam true, enquanto o último PDF, que não é linearizado, retorna false.

ObserveNão existe método para verificar se um objeto PdfDocument em si está linearizado. Isso ocorre porque, ao abrir e carregar um arquivo PDF em um objeto, sua estrutura linearizada especial é perdida. Pelo mesmo motivo, não existe um método para retornar um PDF linearizado como uma matriz de bytes. Essa característica linearizada existe apenas como um arquivo salvo no disco.

Melhores práticas para PDFs linearizados

Ao trabalhar com PDFs linearizados, considere estas boas práticas:

1. Considerações sobre o tamanho do arquivo : A linearização pode aumentar ligeiramente o tamanho do arquivo devido ao formato reestruturado. Utilize os recursos de compressão do IronPDF para otimizar o tamanho do arquivo quando necessário.

2. Implantação na Web : PDFs linearizados são ideais para aplicações web. Configure seu servidor web para suportar solicitações de intervalo de bytes para maximizar os benefícios da linearização.

3. Teste de desempenho : Sempre teste PDFs linearizados no seu ambiente de destino. A melhoria de desempenho é mais perceptível com arquivos grandes em conexões mais lentas.

4. Compatibilidade : Embora a maioria dos visualizadores de PDF modernos suporte PDFs linearizados, assegure-se de que a compatibilidade com os visualizadores preferidos dos seus usuários seja garantida.

Para obter estratégias de otimização adicionais e técnicas avançadas de manipulação de PDFs, consulte a documentação de opções de renderização do IronPDF .