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 werden wir einen HTML-String in ein PDF rendern, indem wir RenderHtmlAsPdf verwenden. 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 als lineares PDF mit der SaveAsLinearized-Instanzmethode, indem wir den Ausgabepfad 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 des PDFs um, indem kritische Informationen an den Anfang der Datei gesetzt werden, was progressives Herunterladen und Rendern ermöglicht. Dies ist besonders vorteilhaft beim Bereitstellen von PDFs über Webanwendungen.

Wie sieht die Ausgabe aus?

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

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

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

// 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

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

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)

Wie streame ich ein linearisiertes PDF zu einer HTTP-Antwort?

Kombinieren Sie LinearizePdfToStream mit FileStreamResult von ASP.NET, um ein weboptimiertes PDF direkt an den Browser zu liefern, ohne eine temporäre Datei zu schreiben:

: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

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

$vbLabelText   $csharpLabel

Der Browser erhält ein linearisiertes PDF, das anfängt, die erste Seite anzuzeigen, während der Rest eingestreamt wird — und keine Zwischendatei jemals die Festplatte des Servers berührt.

---

Meine Lieblingsbibliothek dieser Art ist IronPDF. Es ermöglicht eine schnelle und effiziente Bearbeitung von PDF-Dateien. Es verfügt auch über viele wertvolle Funktionen, wie das Exportieren in das PDF/A-Format und das digitale Signieren von PDF-Dokumenten.

Milan Jovanovic

Microsoft MVP

Fallstudie ansehen

IronOCR bedeutet, dass wir jährlich 40.000 $ durch manuelle Verarbeitung einsparen können, während die Produktivität gesteigert wird und Ressourcen für wichtige Aufgaben freigesetzt werden. Ich würde es sehr empfehlen.

Brent Matzelle

Technischer Leiter, OPYN

Fallstudie ansehen

Die Iron Suite spielt eine entscheidende Rolle in unseren Operationen. Diese Werkzeuge erhöhen die Effizienz im gesamten Unternehmen, einschließlich der Erstellung von Grundrissen und der Verbesserung des Bestandsmanagements.

David Jones

Leitender Software-Ingenieur, Agorus Build

Fallstudie ansehen

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 IsLinearized-Methode zu überprüfen. Es akzeptiert einen Zeichenfolgenparameter für den Dateipfad und einen optionalen zweiten Zeichenfolgenparameter für das Passwort, wenn 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.

Was sind die Ergebnisse?

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

Hinweis:Linearisierung ist eine dateiübergreifende Struktur, daher funktioniert die Verifizierung auf gespeicherten Dateien über IsLinearized. Um lineare Ausgaben als Bytes oder einen Stream zu erzeugen, ohne auf die Festplatte zu schreiben, verwenden Sie die oben beschriebenen LinearizePdfToBytes- und LinearizePdfToStream-Methoden.)

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.