Jak linearyzowac PDFy za pomoca C# i IronPDF

Jak zapisać PDF jako linearyzowany?

Zapisanie dokumentu jako linearyzowanego PDF z IronPDF to proces szybki i łatwy. Przed rozpoczeciem upewnij sie, ze zainstalowales IronPDF za pomoca NuGet lub jednej z innych dostępnych metod instalacji.

W tym przykładzie wyrenderujemy ciąg HTML do PDF przy użyciu RenderHtmlAsPdf. Dla bardziej zlozonych dokumentów HTML warto rozwazyc funkcje konwersji HTML do PDF IronPDF. Następnie zapiszemy obiekt PdfDocument jako zlinearizowany PDF, używając instancyjnej metody SaveAsLinearized, podając ścieżkę wyjściowego pliku jako argument ciągu.

: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 wewnętrzny format 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?

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

Jak przesłać zlinearyzowany plik PDF do odpowiedzi HTTP?

Połącz LinearizePdfToStream z FileStreamResult ASP.NET, aby bezpośrednio przesłać zoptymalizowany PDF do przeglądarki, bez tworzenia pliku tymczasowego:

: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

$vbLabelText   $csharpLabel

Przeglądarka otrzymuje zlinearyzowany plik PDF, który zaczyna wyświetlać pierwszą stronę, podczas gdy reszta jest przesyłana strumieniowo — a żaden plik pośredni nigdy nie trafia na dysk serwera.

---

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jak mogę zweryfikowac, czy PDF jest linearyzowany?

Oprócz sprawdzania własności dokumentu w przeglądarce PDF, takiej jak Adobe Acrobat, aby zobaczyć, czy PDF jest zlinearizowany, IronPDF dostarcza także sposób na programowe sprawdzenie tego 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 capable weryfikacji jest niezbędna dla zapewnienia jakosci i może być zintegrowana z workflowami testow automatycznych.

W tym przykładzie uzyjemy plików wyjsciowych z trzech powyzszych przykładów, aby sprawdzic, czy sa one linearyzowane, oraz dołączymy czwarty, nielinearyzowany PDF, aby pokazac działanie metody. Dla bardziej zaawansowanych technik manipulacji i weryfikacji PDFow, zbadz kompleksowy zestaw funkacji IronPDF.

Jakie sa wyniki?

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

Zwróć uwagęLinearizacja jest strukturą na poziomie pliku, więc weryfikacja działa na zapisanych plikach przez IsLinearized. Aby wygenerować zlinearizowane wyjście jako bajty lub strumień bez pisania na dysk, użyj opisanych powyżej metod LinearizePdfToBytes i LinearizePdfToStream.

Najlepsze praktyki dla linearyzowanych PDFow

Pracujac z linearyzowanymi PDFami, rozwaz te najlepsze praktyki:

1. Rozwazania dotyczące wielkosci plików: linearyzacja może nieznacznie zwiększyć wielkosc pliku ze wzgledu na zrestrukturyzowany format. Uzyj funkcji kompresji IronPDF, aby zoptymalizować wielkosc pliku, gdy to konieczne.

2. Wdrozenie Webowe: Linearyzowane PDFy sa idealne dla aplikacji webowych. Skonfiguruj swoj serwer webowy, aby obsługiwal zapytania o zakres bajtow, aby zmaksymalizowac korzysci z linearyzacji.

3. Testowanie wydajności: Zawsze testuj linearyzowane PDFy w docelowym środowisku. Poprawa wydajności jest najbardziej zauwazalna dla duzych plików przy wolniejszych połączeniach.

4. Zgodnosc: Chociaż wiekszosc nowoczesnych przeglądarek PDF wspiera linearyzowane PDFy, upewnij sie, ze sa zgodne z preferowanymi przeglądarkami użytkowników.

Dla dodatkowych strategii optymalizacji i zaawansowanych technik obsługi PDFow, odwolaj sie do dokumentacji opcji renderowania IronPDF.