Jak liniaryzować pliki PDF przy użyciu języka C# i biblioteki IronPDF

Jak zapisać plik PDF w formacie zlinearyzowanym?

Zapisywanie dokumentu jako zlinearyzowanego pliku PDF za pomocą IronPDF to szybki i łatwy proces. Przed rozpoczęciem upewnij się, że zainstalowałeś IronPDF za pomocą NuGet lub jednej z innych dostępnych metod instalacji.

W tym przykładzie przekonwertujemy ciąg znaków HTML do formatu PDF przy użyciu RenderHtmlAsPdf. W przypadku bardziej złożonych dokumentów HTML warto zapoznać się z funkcjami konwersji HTML do PDF oferowanymi przez IronPDF. Następnie zapiszemy obiekt PdfDocument jako zlinearyzowany plik PDF za pomocą metody instancji SaveAsLinearized, przekazując ścieżkę pliku wyjściowego jako argument typu string.

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

Proces ten zmienia strukturę wewnętrzną pliku PDF, umieszczając kluczowe informacje na początku pliku, co umożliwia stopniowe pobieranie i renderowanie. Jest to szczególnie przydatne podczas udostępniania plików PDF za pośrednictwem aplikacji internetowych.

Jak wygląda wynik?

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

Jak sprawdzić, czy plik PDF jest zlinearyzowany?

Oprócz sprawdzania właściwości dokumentu w przeglądarce plików PDF, takiej jak Adobe Acrobat, w celu ustalenia, czy plik PDF jest zlinearyzowany, IronPDF zapewnia również możliwość sprawdzenia tego programowo za pomocą metody IsLinearized. Przyjmuje parametr typu string dla ścieżki do pliku oraz opcjonalny drugi parametr typu string dla hasła, jeśli plik PDF jest zaszyfrowany. Ta funkcja weryfikacji ma zasadnicze znaczenie dla zapewnienia jakości i może zostać zintegrowana z procesami automatycznego testowania.

W tym przykładzie wykorzystamy pliki wyjściowe z trzech powyższych przykładów, aby sprawdzić, czy są one zlinearyzowane, oraz dołączymy czwarty, niezlinearyzowany plik PDF, aby zademonstrować działanie tej metody. Aby poznać bardziej zaawansowane techniki obróbki i weryfikacji plików PDF, zapoznaj się z kompleksowym zestawem funkcji IronPDF.

Jakie są wyniki?

Jak widać, pierwsze trzy przykłady zwracają MemoryStream, podczas gdy ostatni plik PDF, który nie jest zlinearyzowany, zwraca IsLinearized.

Zwróć uwagęLinearyzacja jest strukturą na poziomie pliku, więc weryfikacja działa na zapisanych plikach poprzez IsLinearized. Aby wygenerować liniowy wynik w postaci bajtów lub strumienia bez zapisywania na dysku, należy użyć metod LinearizePdfToBytes i LinearizePdfToStream opisanych powyżej.

Najlepsze praktyki dotyczące plików PDF w formacie liniowym

Podczas pracy z plikami PDF w formacie zlinearyzowanym należy uwzględnić następujące najlepsze praktyki:

1. Uwagi dotyczące rozmiaru pliku: Liniaryzacja może nieznacznie zwiększyć rozmiar pliku ze względu na zmianę struktury formatu. W razie potrzeby należy skorzystać z funkcji kompresji IronPDF w celu optymalizacji rozmiaru plików.

2. Wdrażanie w sieci: Zlinearyzowane pliki PDF idealnie nadają się do aplikacji internetowych. Skonfiguruj serwer WWW tak, aby obsługiwał żądania zakresu bajtów, co pozwoli w pełni wykorzystać zalety linearyzacji.

3. Testowanie wydajności: Zawsze testuj zlinearyzowane pliki PDF w swoim środowisku docelowym. Poprawa wydajności jest najbardziej zauważalna w przypadku dużych plików przesyłanych przez wolniejsze połączenia.

4. Kompatybilność: Chociaż większość nowoczesnych przeglądarek plików PDF obsługuje pliki PDF w formacie zlinearyzowanym, należy zapewnić kompatybilność z przeglądarkami preferowanymi przez użytkowników.

Aby uzyskać informacje na temat dodatkowych strategii optymalizacji i zaawansowanych technik obsługi plików PDF, zapoznaj się z dokumentacją opcji renderowania IronPDF.