Mit IronPDF PDFs in C#35 linearisieren

Wie speichere ich eine PDF-Datei als linearisierte Datei?

Das Speichern eines Dokuments als linearisiertes PDF mit IronPDF ist ein schneller und einfacher Prozess. Bevor Sie beginnen, stellen Sie sicher, dass Sie IronPDF über NuGet oder über eine der anderen verfügbaren Installationsmethoden installiert haben.

In diesem Beispiel wird eine HTML-Zeichenkette mit RenderHtmlAsPdf in eine PDF-Datei umgewandelt. Für komplexere HTML-Dokumente sollten Sie sich die Funktionen von IronPDF zur Konvertierung von HTML in PDF ansehen. Anschließend speichern wir das PdfDocument-Objekt mit der Instanzmethode SaveAsLinearized als linearisierte PDF-Datei. Diese Methode nimmt ein String-Argument für den Ausgabedateipfad entgegen.

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

Bei der Linearisierung wird das interne Format der PDF-Datei umstrukturiert, wobei wichtige Informationen an den Anfang der Datei gesetzt werden. Dies ermöglicht ein progressives Herunterladen und Rendern, was besonders bei der Bereitstellung von PDF-Dateien über Webanwendungen von Vorteil ist.

Wie sieht die Ausgabe aus?

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

Wie kann ich überprüfen, ob eine PDF-Datei linearisiert ist?

Neben der Überprüfung der Dokumenteigenschaften in einem PDF-Viewer, wie Adobe Acrobat, um zu sehen, ob ein PDF linearisiert ist, bietet IronPDF auch eine Möglichkeit, dies programmatisch mit der Methode IsLinearized zu überprüfen. Die Methode nimmt einen String-Parameter für den Dateipfad und einen optionalen zweiten String-Parameter für das Passwort, falls das PDF verschlüsselt ist. Diese Überprüfungsfunktion ist für die Qualitätssicherung unerlässlich und kann in automatisierte Testabläufe integriert werden.

In diesem Beispiel verwenden wir die Ausgabedateien der drei obigen Beispiele, um zu testen, ob sie linearisiert sind, und fügen eine vierte, nicht linearisierte PDF-Datei hinzu, um das Verhalten der Methode zu zeigen. Weitere fortgeschrittene Techniken zur PDF-Bearbeitung und -Überprüfung finden Sie in IronPDFs umfassendem Funktionsumfang.

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

Was sind die Ergebnisse?

Wie Sie sehen können, geben die ersten drei Beispiele true zurück, während das letzte PDF, das nicht linearisiert ist, false zurückgibt.

Hinweis:Es gibt keine Methode, um zu prüfen, ob ein PdfDocument-Objekt selbst linearisiert ist. Dies liegt daran, dass, wenn eine PDF-Datei geöffnet und in ein Objekt geladen wird, ihre spezielle linearisierte Struktur verloren geht. Aus demselben Grund gibt es keine Methode, um ein linearisiertes PDF als Byte-Array zurückzugeben. Diese linearisierte Funktion ist nur als gespeicherte Datei auf der Festplatte vorhanden.

Best Practices für linearisierte PDFs

Beachten Sie bei der Arbeit mit linearisierten PDF-Dateien die folgenden bewährten Verfahren:

1. Berücksichtigung der Dateigröße: Durch die Linearisierung kann sich die Dateigröße aufgrund des umstrukturierten Formats leicht erhöhen. Verwenden Sie bei Bedarf die Komprimierungsfunktionen von IronPDF, um die Dateigröße zu optimieren.

2. Web-Bereitstellung: Linearisierte PDFs sind ideal für Webanwendungen. Konfigurieren Sie Ihren Webserver so, dass er Byte-Range-Anfragen unterstützt, um die Vorteile der Linearisierung zu maximieren.

3. Leistungsprüfung: Testen Sie linearisierte PDFs immer in Ihrer Zielumgebung. Die Leistungsverbesserung ist vor allem bei großen Dateien über langsamere Verbindungen spürbar.

4. Kompatibilität: Obwohl die meisten modernen PDF-Viewer linearisierte PDFs unterstützen, sollten Sie die Kompatibilität mit den bevorzugten Viewern Ihrer Benutzer sicherstellen.

Weitere Optimierungsstrategien und fortgeschrittene PDF-Verarbeitungstechniken finden Sie in der Dokumentation der Rendering-Optionen von IronPDF.