Como linearizar 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, passando o caminho do arquivo de saída como um argumento de string.

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

Esse processo reestrutura o formato interno do PDF, colocando informações críticas no início do arquivo, o que permite o download e a renderização progressivos. É particularmente vantajoso ao disponibilizar PDFs por meio de aplicações web.

Qual é a aparência do resultado?

using IronPdf;

// Instance method: linearize the current document, get bytes back
var pdf = PdfDocument.FromFile("input.pdf");
byte[] linearizedBytes = pdf.LinearizePdfToBytes();

// Static method: linearize from a byte array without instantiating PdfDocument
byte[] inputBytes = File.ReadAllBytes("input.pdf");
byte[] result = PdfDocument.LinearizePdfToBytes(inputBytes);

// Password-protected PDFs
byte[] decrypted = PdfDocument.LinearizePdfToBytes(encryptedBytes, password: "secret");

using IronPdf;

// Instance method: linearize the current document, get bytes back
var pdf = PdfDocument.FromFile("input.pdf");
byte[] linearizedBytes = pdf.LinearizePdfToBytes();

// Static method: linearize from a byte array without instantiating PdfDocument
byte[] inputBytes = File.ReadAllBytes("input.pdf");
byte[] result = PdfDocument.LinearizePdfToBytes(inputBytes);

// Password-protected PDFs
byte[] decrypted = PdfDocument.LinearizePdfToBytes(encryptedBytes, password: "secret");

Imports IronPdf

' Instance method: linearize the current document, get bytes back
Dim pdf = PdfDocument.FromFile("input.pdf")
Dim linearizedBytes As Byte() = pdf.LinearizePdfToBytes()

' Static method: linearize from a byte array without instantiating PdfDocument
Dim inputBytes As Byte() = File.ReadAllBytes("input.pdf")
Dim result As Byte() = PdfDocument.LinearizePdfToBytes(inputBytes)

' Password-protected PDFs
Dim decrypted As Byte() = PdfDocument.LinearizePdfToBytes(encryptedBytes, password:="secret")

// Instance method: return a Stream
Stream linearizedStream = pdf.LinearizePdfToStream();

// Static method: linearize from a stream
using var inputStream = File.OpenRead("input.pdf");
Stream resultStream = PdfDocument.LinearizePdfToStream(inputStream);

// Instance method: return a Stream
Stream linearizedStream = pdf.LinearizePdfToStream();

// Static method: linearize from a stream
using var inputStream = File.OpenRead("input.pdf");
Stream resultStream = PdfDocument.LinearizePdfToStream(inputStream);

Imports System.IO

' Instance method: return a Stream
Dim linearizedStream As Stream = pdf.LinearizePdfToStream()

' Static method: linearize from a stream
Using inputStream As FileStream = File.OpenRead("input.pdf")
    Dim resultStream As Stream = PdfDocument.LinearizePdfToStream(inputStream)
End Using

using IronPdf;

// Force in-memory linearization (no disk I/O at all)
byte[] linearized = pdf.LinearizePdfToBytes(LinearizationMode.InMemory);

using IronPdf;

// Force in-memory linearization (no disk I/O at all)
byte[] linearized = pdf.LinearizePdfToBytes(LinearizationMode.InMemory);

Imports IronPdf

' Force in-memory linearization (no disk I/O at all)
Dim linearized As Byte() = pdf.LinearizePdfToBytes(LinearizationMode.InMemory)

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

using IronPdf;
using Microsoft.AspNetCore.Mvc;

public class ReportController : Controller
{
    public IActionResult DownloadReport()
    {
        var pdf = PdfDocument.FromFile("quarterly-report.pdf");
        Stream linearized = pdf.LinearizePdfToStream(LinearizationMode.InMemory);

        return new FileStreamResult(linearized, "application/pdf")
        {
            FileDownloadName = "quarterly-report.pdf"
        };
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc
Imports System.IO

Public Class ReportController
    Inherits Controller

    Public Function DownloadReport() As IActionResult
        Dim pdf = PdfDocument.FromFile("quarterly-report.pdf")
        Dim linearized As Stream = pdf.LinearizePdfToStream(LinearizationMode.InMemory)

        Return New FileStreamResult(linearized, "application/pdf") With {
            .FileDownloadName = "quarterly-report.pdf"
        }
    End Function
End Class

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. A função recebe um parâmetro de texto para o caminho do arquivo e um segundo parâmetro de texto 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 .

Quais são os resultados?

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

ObserveA linearização é uma estrutura de nível de arquivo, portanto a verificação funciona em arquivos salvos via IsLinearized. Para produzir saída linearizada como bytes ou um fluxo sem gravar em disco, use os métodos LinearizePdfToBytes e LinearizePdfToStream descritos acima.

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 .