Comment linéariser des PDF à l'aide de C# avec IronPDF

Comment économiser un PDF au format linéarisé ?

Économiser un document au format PDF linéarisé avec IronPDF est un processus rapide et simple. Avant de commencer, assurez-vous d'avoir installé IronPDF via NuGet ou l'une des autres méthodes d'installation disponibles.

Dans cet exemple, nous allons convertir une chaîne HTML en PDF à l'aide de RenderHtmlAsPdf. Pour les documents HTML plus complexes, vous pouvez explorer les fonctionnalités de conversion HTML vers PDF d'IronPDF. Ensuite, nous enregistrerons l'objet PdfDocument sous forme de PDF linéarisé à l'aide de la méthode d'instance SaveAsLinearized, en passant le chemin du fichier de sortie sous forme d'argument de type chaîne.

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

Ce processus restructure le format interne du PDF en plaçant les informations essentielles au début du fichier, ce qui permet un téléchargement et un rendu progressifs. Elle est particulièrement utile lors de la diffusion de fichiers PDF via des applications web.

À quoi ressemble le résultat final ?

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

Comment puis-je vérifier si un PDF est linéarisé ?

Outre la vérification des propriétés du document dans une visionneuse PDF, telle qu'Adobe Acrobat, pour voir si un PDF est linéarisé, IronPDF offre également un moyen de vérifier cela par programmation à l'aide de la méthode IsLinearized. Elle prend un paramètre de type chaîne pour le chemin d'accès au fichier et un deuxième paramètre de type chaîne facultatif pour le mot de passe si le PDF est crypté. Cette fonctionnalité de vérification est essentielle pour l'assurance qualité et peut être intégrée dans des workflows de tests automatisés.

Dans cet exemple, nous utiliserons les fichiers de sortie des trois exemples ci-dessus pour vérifier s'ils sont linéarisés, et inclurons un quatrième PDF non linéarisé pour illustrer le comportement de la méthode. Pour des techniques plus avancées de manipulation et de vérification de fichiers PDF, découvrez l'ensemble complet de fonctionnalités d'IronPDF.

Quels sont les résultats ?

Comme vous pouvez le constater, les trois premiers exemples renvoient MemoryStream, tandis que le dernier PDF, qui n'est pas linéarisé, renvoie IsLinearized.

Veuillez noterLa linéarisation est une structure au niveau du fichier, la vérification s'effectue donc sur les fichiers enregistrés via IsLinearized. Pour produire une sortie linéarisée sous forme d'octets ou de flux sans écriture sur le disque, utilisez les méthodes LinearizePdfToBytes et LinearizePdfToStream décrites ci-dessus.

Meilleures pratiques pour les PDF linéarisés

Lorsque vous travaillez avec des PDF linéarisés, tenez compte des bonnes pratiques suivantes :

1. Considérations relatives à la taille des fichiers : la linéarisation peut légèrement augmenter la taille des fichiers en raison du format restructuré. Utilisez les fonctionnalités de compression d'IronPDF pour optimiser la taille des fichiers si nécessaire.

2. Déploiement Web : les PDF linéarisés sont idéaux pour les applications Web. Configurez votre serveur web pour prendre en charge les requêtes de plage d'octets afin de tirer pleinement parti des avantages de la linéarisation.

3. Tests de performance : Testez toujours les PDF linéarisés dans votre environnement cible. L'amélioration des performances est particulièrement perceptible avec des fichiers volumineux sur des connexions lentes.

4. Compatibilité : bien que la plupart des lecteurs PDF modernes prennent en charge les PDF linéarisés, assurez-vous de la compatibilité avec les lecteurs préférés de vos utilisateurs.

Pour découvrir d'autres stratégies d'optimisation et des techniques avancées de gestion des PDF, consultez la documentation sur les options de rendu d'IronPDF.