Comment linéariser des PDF en utilisant C# ; avec IronPDF

Comment enregistrer un PDF en tant que fichier linéarisé?

<TODO : Ajouter une image ici -->

<Description : Capture d'écran montrant la sortie ou les résultats de l'exécution d'un code -->

Enregistrer un document en tant que PDF linéarisé avec IronPDF est un processus rapide et facile. Avant de commencer, assurez-vous d'avoir installé IronPDF via NuGet ou via l'une des autres méthodes d'installation disponibles.

Dans cet exemple, nous allons transformer 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 en tant que PDF linéarisé à l'aide de la méthode d'instance SaveAsLinearized. Cette méthode prend un argument de type chaîne pour le chemin du fichier de sortie.

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

Le processus de linéarisation restructure le format interne du PDF, en plaçant les informations essentielles au début du fichier. Cela permet un téléchargement et un rendu progressifs, ce qui est particulièrement utile lorsque les PDF sont diffusés par des applications web.

À quoi ressemble le résultat ?

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

Comment vérifier si un PDF est linéarisé?

En plus de vérifier les propriétés du document dans un visualiseur de PDF, tel qu'Adobe Acrobat, pour voir si un PDF est linéarisé, IronPDF fournit également une méthode pour vérifier cela par programmation avec la méthode IsLinearized. La méthode prend un paramètre de type chaîne pour le chemin du fichier et un second paramètre optionnel de type chaîne pour le mot de passe si le PDF est chiffré. Cette capacité de vérification est essentielle pour l'assurance qualité et peut être intégrée dans des flux 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 nous 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 des PDF, explorez l'ensemble des fonctionnalités d'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"))

Quels sont les résultats?

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

Veuillez noterIl n'y a pas de méthode pour vérifier si un objet PdfDocument est lui-même linéarisé. Cela est dû au fait que lorsqu'un fichier PDF est ouvert et chargé dans un objet, sa structure linéarisée spéciale est perdue. Pour la même raison, il n'existe pas de méthode pour retourner un PDF linéarisé sous forme de tableau d'octets. Cette fonctionnalité linéarisée n'existe que sous la forme d'un fichier sauvegardé sur disque.

Bonnes pratiques pour les PDF linéarisés

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

1. <Considérations relatives à la taille des fichiers : La linéarisation peut légèrement augmenter la taille du fichier en raison du format restructuré. Utilisez les fonctions de compression d'IronPDF pour optimiser la taille des fichiers lorsque cela est nécessaire.

2. <Déploiement sur le web : Les PDF linéarisés sont idéaux pour les applications web. Configurez votre serveur web pour qu'il prenne en charge les requêtes par octets afin de maximiser les avantages de la linéarisation.

3. Test de performance : Testez toujours les PDF linéarisés dans votre environnement cible. L'amélioration des performances est surtout perceptible avec les fichiers volumineux et les connexions plus lentes.

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

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