So linearisieren Sie PDFs mit C# und IronPDF

Wie speichere ich eine PDF-Datei als linearisierte Datei?

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

In diesem Beispiel rendern wir eine HTML-Zeichenkette mithilfe von RenderHtmlAsPdf in eine PDF-Datei. Für komplexere HTML-Dokumente empfehlen wir Ihnen, die Funktionen von IronPDF zur Konvertierung von HTML in PDF zu nutzen. Anschließend speichern wir das PdfDocument-Objekt mithilfe der SaveAsLinearized-Instanzmethode als linearisierte PDF-Datei, wobei wir den Pfad der Ausgabedatei als String-Argument übergeben.

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

Dieser Prozess strukturiert das interne Format der PDF-Datei neu und platziert wichtige Informationen am Anfang der Datei, was ein progressives Herunterladen und Rendern ermöglicht. Dies ist besonders vorteilhaft, wenn PDF-Dateien über Webanwendungen bereitgestellt werden.

Wie sieht das Ergebnis aus?

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

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 festzustellen, ob ein PDF linearisiert ist, bietet IronPDF auch eine Möglichkeit, dies programmgesteuert mit der Methode IsLinearized zu überprüfen. Sie benötigt einen String-Parameter für den Dateipfad und einen optionalen zweiten String-Parameter für das Passwort, falls die PDF-Datei verschlüsselt ist. Diese Verifizierungsfunktion ist für die Qualitätssicherung unerlässlich und kann in automatisierte Testabläufe integriert werden.

In diesem Beispiel verwenden wir die Ausgabedateien aus den drei obigen Beispielen, um zu testen, ob sie linearisiert sind, und fügen eine vierte, nicht linearisierte PDF-Datei hinzu, um das Verhalten der Methode zu veranschaulichen. Für fortgeschrittenere Techniken zur Bearbeitung und Überprüfung von PDF-Dateien entdecken Sie den umfassenden Funktionsumfang von IronPDF.

Wie sehen die Ergebnisse aus?

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

Hinweis:Linearisierung ist eine Struktur auf Dateiebene, daher erfolgt die Überprüfung gespeicherter Dateien über IsLinearized. Um eine linearisierte Ausgabe als Bytes oder Stream zu erzeugen, ohne auf die Festplatte zu schreiben, verwenden Sie die oben beschriebenen Methoden LinearizePdfToBytes und LinearizePdfToStream.

Bewährte Verfahren für linearisierte PDFs

Beachten Sie bei der Arbeit mit linearisierten PDFs die folgenden Best Practices:

1. Überlegungen zur Dateigröße: Durch die Linearisierung kann sich die Dateigröße aufgrund des umstrukturierten Formats geringfügig erhöhen. Nutzen Sie bei Bedarf die Komprimierungsfunktionen von IronPDF, um die Dateigröße zu optimieren.

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

3. Leistungstests: Testen Sie linearisierte PDFs immer in Ihrer Zielumgebung. Die Leistungssteigerung macht sich vor allem bei großen Dateien über langsamere Verbindungen bemerkbar.

4. Kompatibilität: Obwohl die meisten modernen PDF-Viewer linearisierte PDFs unterstützen, stellen Sie bitte die Kompatibilität mit den von Ihren Nutzern bevorzugten Viewern sicher.

Weitere Optimierungsstrategien und fortgeschrittene Techniken zur PDF-Bearbeitung finden Sie in der Dokumentation zu den Rendering-Optionen von IronPDF.